Main Page

<mediawiki xmlns="http://www.mediawiki.org/xml/export-0.11/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.mediawiki.org/xml/export-0.11/ http://www.mediawiki.org/xml/export-0.11.xsd" version="0.11" xml:lang="en">
  <siteinfo>
    <sitename>Mineserver Wiki</sitename>
    <dbname>mineserver_wiki</dbname>
    <base>https://mineserver.be/wiki/Main_Page</base>
    <generator>MediaWiki 1.35.12</generator>
    <case>first-letter</case>
    <namespaces>
      <namespace key="-2" case="first-letter">Media</namespace>
      <namespace key="-1" case="first-letter">Special</namespace>
      <namespace key="0" case="first-letter" />
      <namespace key="1" case="first-letter">Talk</namespace>
      <namespace key="2" case="first-letter">User</namespace>
      <namespace key="3" case="first-letter">User talk</namespace>
      <namespace key="4" case="first-letter">Mineserver Wiki</namespace>
      <namespace key="5" case="first-letter">Mineserver Wiki talk</namespace>
      <namespace key="6" case="first-letter">File</namespace>
      <namespace key="7" case="first-letter">File talk</namespace>
      <namespace key="8" case="first-letter">MediaWiki</namespace>
      <namespace key="9" case="first-letter">MediaWiki talk</namespace>
      <namespace key="10" case="first-letter">Template</namespace>
      <namespace key="11" case="first-letter">Template talk</namespace>
      <namespace key="12" case="first-letter">Help</namespace>
      <namespace key="13" case="first-letter">Help talk</namespace>
      <namespace key="14" case="first-letter">Category</namespace>
      <namespace key="15" case="first-letter">Category talk</namespace>
    </namespaces>
  </siteinfo>
<page arvcontinue="">
  <title>Main Page</title>
  <ns>0</ns>
  <id>1</id>
  <revision>
    <id>1</id>
    <timestamp>2010-11-26T02:52:29Z</timestamp>
    <contributor>
      <username>MediaWiki default</username>
      <id>0</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="438" xml:space="preserve">'''MediaWiki has been successfully installed.'''

Consult the [http://meta.wikimedia.org/wiki/Help:Contents User's Guide] for information on using the wiki software.

== Getting started ==
* [http://www.mediawiki.org/wiki/Manual:Configuration_settings Configuration settings list]
* [http://www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ]
* [https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mailing list]</text>
    <sha1>25b5c21bea6319ae81e1379d4e59bdfe9100ce36</sha1>
  </revision>
  <revision>
    <id>2</id>
    <parentid>1</parentid>
    <timestamp>2010-11-26T12:45:00Z</timestamp>
    <contributor>
      <username>Mineserver</username>
      <id>1</id>
    </contributor>
    <comment>Replaced content with "'''Please wait, content coming Soon (tm)'''"</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="43" xml:space="preserve">'''Please wait, content coming Soon (tm)'''</text>
    <sha1>02684ef9c2cf1822d2f8dac7fc0aea10c341b56a</sha1>
  </revision>
  <revision>
    <id>4</id>
    <parentid>2</parentid>
    <timestamp>2010-11-28T05:00:48Z</timestamp>
    <contributor>
      <username>Deoxxa</username>
      <id>3</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="577" xml:space="preserve">Hi there! Welcome to the Mineserver wiki. Below is a list of articles that may or may not need writing. This page will be fleshed out when we have some more content here.

If you feel like creating, fixing and/or adding anything, you can log in with your forum account. If you don't yet have a forum account, you can create one [http://mineserver.be/forums/ here]. This wiki will become publicly editable when there are a few more users and we have some spam/vandal control in place.

* [[Installation]]
* [[Configuration]]
* [[Frequently Asked Questions]]
* [[Advanced Usage]]</text>
    <sha1>db1a20590dacc2351871d10a09c09c498a04070b</sha1>
  </revision>
  <revision>
    <id>21</id>
    <parentid>4</parentid>
    <timestamp>2010-11-29T00:09:02Z</timestamp>
    <contributor>
      <username>Pacino</username>
      <id>6</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="592" xml:space="preserve">Hi there! Welcome to the Mineserver wiki. Below is a list of articles that may or may not need writing. This page will be fleshed out when we have some more content here.

If you feel like creating, fixing and/or adding anything, you can log in with your forum account. If you don't yet have a forum account, you can create one [http://mineserver.be/forums/ here]. This wiki will become publicly editable when there are a few more users and we have some spam/vandal control in place.

* [[Installation]]
* [[Configuration]]
* [[Commands]]
* [[Frequently Asked Questions]]
* [[Advanced Usage]]</text>
    <sha1>3984d6f1fcb55608b0987093ab0a2acb7ba8d7e9</sha1>
  </revision>
  <revision>
    <id>45</id>
    <parentid>21</parentid>
    <timestamp>2010-12-06T22:09:58Z</timestamp>
    <contributor>
      <username>Bakkdoor</username>
      <id>11</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="611" xml:space="preserve">Hi there! Welcome to the Mineserver wiki. Below is a list of articles that may or may not need writing. This page will be fleshed out when we have some more content here.

If you feel like creating, fixing and/or adding anything, you can log in with your forum account. If you don't yet have a forum account, you can create one [http://mineserver.be/forums/ here]. This wiki will become publicly editable when there are a few more users and we have some spam/vandal control in place.

* [[Installation]]
* [[Configuration]]
* [[Commands]]
* [[Frequently Asked Questions]]
* [[Advanced Usage]]
* [[Coding Style]]</text>
    <sha1>627a4fa764c6d94f324783f754e94bd78aa07bd2</sha1>
  </revision>
</page>
<page arvcontinue="">
  <title>Configuration</title>
  <ns>0</ns>
  <id>2</id>
  <revision>
    <id>3</id>
    <timestamp>2010-11-28T04:51:21Z</timestamp>
    <contributor>
      <username>Deoxxa</username>
      <id>3</id>
    </contributor>
    <comment>first revision, needs a look-over</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2131" xml:space="preserve">Mineserver uses a collection of text files for configuration. They can be edited in any regular text editor and follow the format of &lt;code&gt;key = value&lt;/code&gt;.

List of files:

==config.cfg==

This is the main configuration file where you will set the core options for the server. A default config file is provided with each distribution of Mineserver.

====Available Options====

{| class="wikitable"
|-
! Name
! Description
! Optional
! Default
|-
| port
| The port that the server will listen on.
| Y
| 25565
|-
| servername
| The name of the server as displayed to the client and on the server list.
| N
|
|-
| userlimit
| The number of users allowed to be connected at any one time.
| Y
| 50
|-
| map_release_time
| The amount of time (in seconds) that a chunk will be kept in memory for without being accessed or modified.
| Y
| 10
|-
| mapdir
| The directory where the map data will be held.
| N
| testmap
|-
| wrong_protocol_message
| The text displayed to clients if their version of Minecraft is incorrect.
| N
| Wrong protocol version
|-
| server_full_message
| The text displayed to clients if the server is full when they try to join.
| N
| Server is currently full
|-
| default_kick_message
| The message sent to a client when they are kicked _if_ no message is specified.
| N
| This is a default kick message
|-
| kit_&lt;name&gt;
| A comma separated list of items to give to players when they use the /kit &lt;name&gt; command. Any number of kits can be defined.
| Y
| kit_starter = "273, 274, 275, 50, 50, 50, 50, 50"
|-
| liquid_physics
| Whether or not to simulate water/lava physics.
| Y
| true
|-
| map_flatland
| Whether or not to generate flatland maps.
| Y
| false
|}

==item_alias.cfg==

This is a set of item name/id pairs for use with the /give command and other parts of the application. Multiple item names can be defined for a single ID by simply using it twice.

==admin.txt==

This is a list of administrators, one per line.

==motd.txt==

This file holds the message of the day, displayed to users as they connect or use /motd.

==rules.txt==

This file holds the rules, displayed to users when they use /rules.</text>
    <sha1>78a6192767213f3f16f1ccfebb7071b7aed22a38</sha1>
  </revision>
  <revision>
    <id>15</id>
    <parentid>3</parentid>
    <timestamp>2010-11-28T12:41:23Z</timestamp>
    <contributor>
      <username>FogWraith</username>
      <id>5</id>
    </contributor>
    <comment>/* Available Options */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2524" xml:space="preserve">Mineserver uses a collection of text files for configuration. They can be edited in any regular text editor and follow the format of &lt;code&gt;key = value&lt;/code&gt;.

List of files:

==config.cfg==

This is the main configuration file where you will set the core options for the server. A default config file is provided with each distribution of Mineserver.

====Available Options====

{| class="wikitable"
|-
! Name
! Description
! Optional
! Default
|-
| ip
| Specifies the IP to bind to.
| Y
| 0.0.0.0
|-
| port
| The port that the server will listen on.
| Y
| 25565
|-
| servername
| The name of the server as displayed to the client and on the server list.
| N
|
|-
| userlimit
| The number of users allowed to be connected at any one time.
| Y
| 50
|-
| map_release_time
| The amount of time (in seconds) that a chunk will be kept in memory for without being accessed or modified.
| Y
| 10
|-
| use_whitelist
| Defines the usage of a whitelist.
| Y
| false
|-
| mapdir
| The directory where the map data will be held.
| N
| testmap
|-
| wrong_protocol_message
| The text displayed to clients if their version of Minecraft is incorrect.
| N
| Wrong protocol version
|-
| server_full_message
| The text displayed to clients if the server is full when they try to join.
| N
| Server is currently full
|-
| default_kick_message
| The message sent to a client when they are kicked _if_ no message is specified.
| N
| This is a default kick message
|-
| default_banned_message
| The message sent to a client when they try to log on, and are banned.
| N
| You have been banned from this server
|-
| default_whitelist_message
| If a player is not on the whitelist, this gets sent to them.
| N
| You are not on the whitelist
|-
| kit_&lt;name&gt;
| A comma separated list of items to give to players when they use the /kit &lt;name&gt; command. Any number of kits can be defined.
| Y
| kit_starter = "273, 274, 275, 50, 50, 50, 50, 50"
|-
| liquid_physics
| Whether or not to simulate water/lava physics.
| Y
| true
|-
| map_flatland
| Whether or not to generate flatland maps.
| Y
| false
|}

==item_alias.cfg==

This is a set of item name/id pairs for use with the /give command and other parts of the application. Multiple item names can be defined for a single ID by simply using it twice.

==admin.txt==

This is a list of administrators, one per line.

==motd.txt==

This file holds the message of the day, displayed to users as they connect or use /motd.

==rules.txt==

This file holds the rules, displayed to users when they use /rules.</text>
    <sha1>02fe3eef090ab6061e4bf161516f42e0b383cf68</sha1>
  </revision>
  <revision>
    <id>16</id>
    <parentid>15</parentid>
    <timestamp>2010-11-28T12:43:16Z</timestamp>
    <contributor>
      <username>FogWraith</username>
      <id>5</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2667" xml:space="preserve">Mineserver uses a collection of text files for configuration. They can be edited in any regular text editor and follow the format of &lt;code&gt;key = value&lt;/code&gt;.

List of files:

==config.cfg==

This is the main configuration file where you will set the core options for the server. A default config file is provided with each distribution of Mineserver.

====Available Options====

{| class="wikitable"
|-
! Name
! Description
! Optional
! Default
|-
| ip
| Specifies the IP to bind to.
| Y
| 0.0.0.0
|-
| port
| The port that the server will listen on.
| Y
| 25565
|-
| servername
| The name of the server as displayed to the client and on the server list.
| N
|
|-
| userlimit
| The number of users allowed to be connected at any one time.
| Y
| 50
|-
| map_release_time
| The amount of time (in seconds) that a chunk will be kept in memory for without being accessed or modified.
| Y
| 10
|-
| use_whitelist
| Defines the usage of a whitelist.
| Y
| false
|-
| mapdir
| The directory where the map data will be held.
| N
| testmap
|-
| wrong_protocol_message
| The text displayed to clients if their version of Minecraft is incorrect.
| N
| Wrong protocol version
|-
| server_full_message
| The text displayed to clients if the server is full when they try to join.
| N
| Server is currently full
|-
| default_kick_message
| The message sent to a client when they are kicked _if_ no message is specified.
| N
| This is a default kick message
|-
| default_banned_message
| The message sent to a client when they try to log on, and are banned.
| N
| You have been banned from this server
|-
| default_whitelist_message
| If a player is not on the whitelist, this gets sent to them.
| N
| You are not on the whitelist
|-
| kit_&lt;name&gt;
| A comma separated list of items to give to players when they use the /kit &lt;name&gt; command. Any number of kits can be defined.
| Y
| kit_starter = "273, 274, 275, 50, 50, 50, 50, 50"
|-
| liquid_physics
| Whether or not to simulate water/lava physics.
| Y
| true
|-
| map_flatland
| Whether or not to generate flatland maps.
| Y
| false
|}

==item_alias.cfg==

This is a set of item name/id pairs for use with the /give command and other parts of the application. Multiple item names can be defined for a single ID by simply using it twice.

==admin.txt==

This is a list of administrators, one per line.

==banned.txt==

This is a list of banned players, one per line.

==motd.txt==

This file holds the message of the day, displayed to users as they connect or use /motd.

==rules.txt==

This file holds the rules, displayed to users when they use /rules.

==whitelist.txt==

This is a list of players on the whitelist, one per line.</text>
    <sha1>3da15ab619dccd2d77bd7610c314587923637ce6</sha1>
  </revision>
</page>
<page arvcontinue="">
  <title>Installation</title>
  <ns>0</ns>
  <id>3</id>
  <revision>
    <id>5</id>
    <timestamp>2010-11-28T06:42:07Z</timestamp>
    <contributor>
      <username>Deoxxa</username>
      <id>3</id>
    </contributor>
    <comment>first revision, needs windows instructions added</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2085" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

This will be written up when there are binary releases available.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

===Building Mineserver===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build the mineserver binary, simply enter the &lt;code&gt;src&lt;/code&gt; directory in the source distribution and run &lt;code&gt;make&lt;/code&gt;. If you receive errors referring to missing files, check that you have all the prerequisites installed.

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>5785463062007ebbac30e2fa9b4ef6be9a113f8b</sha1>
  </revision>
  <revision>
    <id>6</id>
    <parentid>5</parentid>
    <timestamp>2010-11-28T06:59:47Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>/* Installing prerequisites */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2870" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

This will be written up when there are binary releases available.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS/RHEL====

CentOS/RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  cp -R include /usr/local/include/libnoise
  cp lib/* /usr/local/lib
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig
  
All other dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel libnoise-dev

===Building Mineserver===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build the mineserver binary, simply enter the &lt;code&gt;src&lt;/code&gt; directory in the source distribution and run &lt;code&gt;make&lt;/code&gt;. If you receive errors referring to missing files, check that you have all the prerequisites installed.

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>f644674274696520f453449c7f3ee378c9e688b7</sha1>
  </revision>
  <revision>
    <id>7</id>
    <parentid>6</parentid>
    <timestamp>2010-11-28T07:01:36Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>/* CentOS/RHEL */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2875" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

This will be written up when there are binary releases available.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS/RHEL====

CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  cp -R include /usr/local/include/libnoise
  cp lib/* /usr/local/lib
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig
  
All other dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel libnoise-dev

===Building Mineserver===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build the mineserver binary, simply enter the &lt;code&gt;src&lt;/code&gt; directory in the source distribution and run &lt;code&gt;make&lt;/code&gt;. If you receive errors referring to missing files, check that you have all the prerequisites installed.

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>3c5972d9f92aa671240c63d5ac693df36a24b2c7</sha1>
  </revision>
  <revision>
    <id>8</id>
    <parentid>7</parentid>
    <timestamp>2010-11-28T07:02:13Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>/* CentOS/RHEL */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2873" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

This will be written up when there are binary releases available.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS/RHEL====

CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  cp -R include /usr/local/include/libnoise
  cp lib/* /usr/local/lib
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

All other dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel libnoise-dev

===Building Mineserver===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build the mineserver binary, simply enter the &lt;code&gt;src&lt;/code&gt; directory in the source distribution and run &lt;code&gt;make&lt;/code&gt;. If you receive errors referring to missing files, check that you have all the prerequisites installed.

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>955cd3402d71598771a4810664e84ff3a37685e9</sha1>
  </revision>
  <revision>
    <id>9</id>
    <parentid>8</parentid>
    <timestamp>2010-11-28T07:03:24Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>/* CentOS/RHEL */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2860" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

This will be written up when there are binary releases available.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS/RHEL====

CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  cp -R include /usr/local/include/libnoise
  cp lib/* /usr/local/lib
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

All other dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

===Building Mineserver===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build the mineserver binary, simply enter the &lt;code&gt;src&lt;/code&gt; directory in the source distribution and run &lt;code&gt;make&lt;/code&gt;. If you receive errors referring to missing files, check that you have all the prerequisites installed.

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>88d20f1625cbdf047eac3b53e715fe9b08b7f25b</sha1>
  </revision>
  <revision>
    <id>10</id>
    <parentid>9</parentid>
    <timestamp>2010-11-28T07:03:30Z</timestamp>
    <contributor>
      <username>Deoxxa</username>
      <id>3</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2851" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

This will be written up when there are binary releases available.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS/RHEL====

CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  cp -R include /usr/local/include/libnoise
  cp lib/* /usr/local/lib
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

All other dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, simply enter the &lt;code&gt;src&lt;/code&gt; directory in the source distribution and run &lt;code&gt;make&lt;/code&gt;. If you receive errors referring to missing files, check that you have all the prerequisites installed.

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>f9132a329f10e1508989eaebc066a93f6c4a7222</sha1>
  </revision>
  <revision>
    <id>11</id>
    <parentid>10</parentid>
    <timestamp>2010-11-28T07:06:56Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>/* CentOS/RHEL */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2858" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

This will be written up when there are binary releases available.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  cp -R include /usr/local/include/libnoise
  cp lib/* /usr/local/lib
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

All other dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, simply enter the &lt;code&gt;src&lt;/code&gt; directory in the source distribution and run &lt;code&gt;make&lt;/code&gt;. If you receive errors referring to missing files, check that you have all the prerequisites installed.

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>6382112b887a0c4674e1bb85a83b7e7a625735b0</sha1>
  </revision>
  <revision>
    <id>12</id>
    <parentid>11</parentid>
    <timestamp>2010-11-28T07:15:08Z</timestamp>
    <contributor>
      <username>Deoxxa</username>
      <id>3</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="5022" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

This will be written up when there are binary releases available.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  cp -R include /usr/local/include/libnoise
  cp lib/* /usr/local/lib
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

All other dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that here:

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>4032ed4b4841c6a3068edba672f8a2dad778ba7c</sha1>
  </revision>
  <revision>
    <id>14</id>
    <parentid>12</parentid>
    <timestamp>2010-11-28T12:06:49Z</timestamp>
    <contributor>
      <username>Deoxxa</username>
      <id>3</id>
    </contributor>
    <comment>got rid of that horrible long line of code</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="5026" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

This will be written up when there are binary releases available.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  cp -R include /usr/local/include/libnoise
  cp lib/* /usr/local/lib
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

All other dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that here:

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>2aeee3abc33cd4dbaab16ef75e95dad978285cd2</sha1>
  </revision>
  <revision>
    <id>17</id>
    <parentid>14</parentid>
    <timestamp>2010-11-28T21:22:36Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>/* CentOS and Red Hat */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="5160" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

This will be written up when there are binary releases available.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  cp -R include /usr/local/include/libnoise
  cp lib/* /usr/local/lib
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

All other dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that here:

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>b7cfdda8266244001f867a1ac8da6a67af9190f1</sha1>
  </revision>
  <revision>
    <id>22</id>
    <parentid>17</parentid>
    <timestamp>2010-11-29T02:46:59Z</timestamp>
    <contributor>
      <username>Mk</username>
      <id>7</id>
    </contributor>
    <minor/>
    <comment>/* Installing prerequisites */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="5958" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

This will be written up when there are binary releases available.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  cp -R include /usr/local/include/libnoise
  cp lib/* /usr/local/lib
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

All other dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Arch Linux stores the development headers in ''/usr/local/include/noise'' and not ''/usr/local/include/libnoise'' like the minesever build script thinks it will.

You can either change it in the mineserver source code - or - move it to the right location.

===== Change the source code =====
If you want to replace all instances of 'libnoise' with 'noise' in the source code, you can simply run the &lt;code&gt;sed&lt;/code&gt; application (it's usually released with all major distributions), like so:

  sed -i 's:libnoise:noise:g' mapgen.{h,cpp}

You can then proceed to run the &lt;code&gt;make&lt;/code&gt; command.

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that here:

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>c12dc63f83e518da02c64e3f9dfaff78c2521246</sha1>
  </revision>
  <revision>
    <id>23</id>
    <parentid>22</parentid>
    <timestamp>2010-11-29T10:42:03Z</timestamp>
    <contributor>
      <username>Batterseapower</username>
      <id>9</id>
    </contributor>
    <comment>OS X installation</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="7251" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

This will be written up when there are binary releases available.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  cp -R include /usr/local/include/libnoise
  cp lib/* /usr/local/lib
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

All other dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Arch Linux stores the development headers in ''/usr/local/include/noise'' and not ''/usr/local/include/libnoise'' like the minesever build script thinks it will.

You can either change it in the mineserver source code - or - move it to the right location.

====OS X====
You can install zlib and libevent using Macports:

 sudo port install zlib libevent

You will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

Finally, we need to create a symlink so that Mineserver finds the header files where it expects them (this saves us using sed on the source code):

 sudo ln -s /usr/local/include/noise /usr/local/include/libnoise

===== Change the source code =====
If you want to replace all instances of 'libnoise' with 'noise' in the source code, you can simply run the &lt;code&gt;sed&lt;/code&gt; application (it's usually released with all major distributions), like so:

  sed -i 's:libnoise:noise:g' mapgen.{h,cpp}

You can then proceed to run the &lt;code&gt;make&lt;/code&gt; command.

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that here:

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

====OS X====

Firstly, until batterseapowers patches are merged, you need to change these lines in src/Makefile:

 LDFLAGS = -L/usr/local/lib -L/usr/lib -levent -lz -lnoise $(LFLAGS)
 CXXFLAGS = $(DFLAGS) -I. -I/usr/Local/include -I/usr/include

To these:

 LDFLAGS += -L/usr/local/lib -L/usr/lib -levent -lz -lnoise $(LFLAGS)
 CXXFLAGS += $(DFLAGS) -I. -I/usr/Local/include -I/usr/include

This just allows us to supply some extra LDFLAGS and CXXFLAGS on the command line. Now you can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

 cd src
 CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>8f8d9396bc067d6709e28aaa834fb3ee0308b47d</sha1>
  </revision>
  <revision>
    <id>24</id>
    <parentid>23</parentid>
    <timestamp>2010-11-29T10:42:36Z</timestamp>
    <contributor>
      <username>Batterseapower</username>
      <id>9</id>
    </contributor>
    <minor/>
    <comment>Change the source code went into the wrong section</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="7251" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

This will be written up when there are binary releases available.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  cp -R include /usr/local/include/libnoise
  cp lib/* /usr/local/lib
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

All other dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Arch Linux stores the development headers in ''/usr/local/include/noise'' and not ''/usr/local/include/libnoise'' like the minesever build script thinks it will.

You can either change it in the mineserver source code - or - move it to the right location.

===== Change the source code =====
If you want to replace all instances of 'libnoise' with 'noise' in the source code, you can simply run the &lt;code&gt;sed&lt;/code&gt; application (it's usually released with all major distributions), like so:

  sed -i 's:libnoise:noise:g' mapgen.{h,cpp}

You can then proceed to run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====
You can install zlib and libevent using Macports:

 sudo port install zlib libevent

You will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

Finally, we need to create a symlink so that Mineserver finds the header files where it expects them (this saves us using sed on the source code):

 sudo ln -s /usr/local/include/noise /usr/local/include/libnoise

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that here:

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

====OS X====

Firstly, until batterseapowers patches are merged, you need to change these lines in src/Makefile:

 LDFLAGS = -L/usr/local/lib -L/usr/lib -levent -lz -lnoise $(LFLAGS)
 CXXFLAGS = $(DFLAGS) -I. -I/usr/Local/include -I/usr/include

To these:

 LDFLAGS += -L/usr/local/lib -L/usr/lib -levent -lz -lnoise $(LFLAGS)
 CXXFLAGS += $(DFLAGS) -I. -I/usr/Local/include -I/usr/include

This just allows us to supply some extra LDFLAGS and CXXFLAGS on the command line. Now you can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

 cd src
 CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>c37f4bfdbd1f231283bf709cb76e4b8b1d5a3fee</sha1>
  </revision>
  <revision>
    <id>25</id>
    <parentid>24</parentid>
    <timestamp>2010-11-29T14:56:11Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <comment>/* Binary Packages */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="7306" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  cp -R include /usr/local/include/libnoise
  cp lib/* /usr/local/lib
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

All other dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Arch Linux stores the development headers in ''/usr/local/include/noise'' and not ''/usr/local/include/libnoise'' like the minesever build script thinks it will.

You can either change it in the mineserver source code - or - move it to the right location.

===== Change the source code =====
If you want to replace all instances of 'libnoise' with 'noise' in the source code, you can simply run the &lt;code&gt;sed&lt;/code&gt; application (it's usually released with all major distributions), like so:

  sed -i 's:libnoise:noise:g' mapgen.{h,cpp}

You can then proceed to run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====
You can install zlib and libevent using Macports:

 sudo port install zlib libevent

You will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

Finally, we need to create a symlink so that Mineserver finds the header files where it expects them (this saves us using sed on the source code):

 sudo ln -s /usr/local/include/noise /usr/local/include/libnoise

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that here:

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

====OS X====

Firstly, until batterseapowers patches are merged, you need to change these lines in src/Makefile:

 LDFLAGS = -L/usr/local/lib -L/usr/lib -levent -lz -lnoise $(LFLAGS)
 CXXFLAGS = $(DFLAGS) -I. -I/usr/Local/include -I/usr/include

To these:

 LDFLAGS += -L/usr/local/lib -L/usr/lib -levent -lz -lnoise $(LFLAGS)
 CXXFLAGS += $(DFLAGS) -I. -I/usr/Local/include -I/usr/include

This just allows us to supply some extra LDFLAGS and CXXFLAGS on the command line. Now you can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

 cd src
 CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>39bca9077578a58239b1b8e4b3a030d985d64f6b</sha1>
  </revision>
  <revision>
    <id>26</id>
    <parentid>25</parentid>
    <timestamp>2010-11-29T19:30:16Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <comment>/* Debian and Similar */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="7333" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

Then run:
  make DEBIAN=1

====CentOS and Red Hat====

CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  cp -R include /usr/local/include/libnoise
  cp lib/* /usr/local/lib
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

All other dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Arch Linux stores the development headers in ''/usr/local/include/noise'' and not ''/usr/local/include/libnoise'' like the minesever build script thinks it will.

You can either change it in the mineserver source code - or - move it to the right location.

===== Change the source code =====
If you want to replace all instances of 'libnoise' with 'noise' in the source code, you can simply run the &lt;code&gt;sed&lt;/code&gt; application (it's usually released with all major distributions), like so:

  sed -i 's:libnoise:noise:g' mapgen.{h,cpp}

You can then proceed to run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====
You can install zlib and libevent using Macports:

 sudo port install zlib libevent

You will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

Finally, we need to create a symlink so that Mineserver finds the header files where it expects them (this saves us using sed on the source code):

 sudo ln -s /usr/local/include/noise /usr/local/include/libnoise

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that here:

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

====OS X====

Firstly, until batterseapowers patches are merged, you need to change these lines in src/Makefile:

 LDFLAGS = -L/usr/local/lib -L/usr/lib -levent -lz -lnoise $(LFLAGS)
 CXXFLAGS = $(DFLAGS) -I. -I/usr/Local/include -I/usr/include

To these:

 LDFLAGS += -L/usr/local/lib -L/usr/lib -levent -lz -lnoise $(LFLAGS)
 CXXFLAGS += $(DFLAGS) -I. -I/usr/Local/include -I/usr/include

This just allows us to supply some extra LDFLAGS and CXXFLAGS on the command line. Now you can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

 cd src
 CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>8408f611b717b05e5fe23db4cdfe905b5137933d</sha1>
  </revision>
  <revision>
    <id>27</id>
    <parentid>26</parentid>
    <timestamp>2010-11-29T19:30:44Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <comment>/* Arch Linux */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="6771" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

Then run:
  make DEBIAN=1

====CentOS and Red Hat====

CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  cp -R include /usr/local/include/libnoise
  cp lib/* /usr/local/lib
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

All other dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====
You can install zlib and libevent using Macports:

 sudo port install zlib libevent

You will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

Finally, we need to create a symlink so that Mineserver finds the header files where it expects them (this saves us using sed on the source code):

 sudo ln -s /usr/local/include/noise /usr/local/include/libnoise

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that here:

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

====OS X====

Firstly, until batterseapowers patches are merged, you need to change these lines in src/Makefile:

 LDFLAGS = -L/usr/local/lib -L/usr/lib -levent -lz -lnoise $(LFLAGS)
 CXXFLAGS = $(DFLAGS) -I. -I/usr/Local/include -I/usr/include

To these:

 LDFLAGS += -L/usr/local/lib -L/usr/lib -levent -lz -lnoise $(LFLAGS)
 CXXFLAGS += $(DFLAGS) -I. -I/usr/Local/include -I/usr/include

This just allows us to supply some extra LDFLAGS and CXXFLAGS on the command line. Now you can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

 cd src
 CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>f31daf7536d012f2664eb9cb60c1d72f20ba21e3</sha1>
  </revision>
  <revision>
    <id>28</id>
    <parentid>27</parentid>
    <timestamp>2010-11-29T19:31:15Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <comment>/* OS X */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="6557" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

Then run:
  make DEBIAN=1

====CentOS and Red Hat====

CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  cp -R include /usr/local/include/libnoise
  cp lib/* /usr/local/lib
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

All other dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====
You can install zlib and libevent using Macports:

 sudo port install zlib libevent

You will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that here:

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

====OS X====

Firstly, until batterseapowers patches are merged, you need to change these lines in src/Makefile:

 LDFLAGS = -L/usr/local/lib -L/usr/lib -levent -lz -lnoise $(LFLAGS)
 CXXFLAGS = $(DFLAGS) -I. -I/usr/Local/include -I/usr/include

To these:

 LDFLAGS += -L/usr/local/lib -L/usr/lib -levent -lz -lnoise $(LFLAGS)
 CXXFLAGS += $(DFLAGS) -I. -I/usr/Local/include -I/usr/include

This just allows us to supply some extra LDFLAGS and CXXFLAGS on the command line. Now you can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

 cd src
 CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>bf6150baeeff18549841bfc3cba76093d0edf095</sha1>
  </revision>
  <revision>
    <id>29</id>
    <parentid>28</parentid>
    <timestamp>2010-11-29T19:32:25Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <comment>/* CentOS and Red Hat */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="6554" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

Then run:
  make DEBIAN=1

====CentOS and Red Hat====

CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  cp -R include /usr/local/include/noise
  cp lib/* /usr/local/lib
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

All other dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====
You can install zlib and libevent using Macports:

 sudo port install zlib libevent

You will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that here:

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

====OS X====

Firstly, until batterseapowers patches are merged, you need to change these lines in src/Makefile:

 LDFLAGS = -L/usr/local/lib -L/usr/lib -levent -lz -lnoise $(LFLAGS)
 CXXFLAGS = $(DFLAGS) -I. -I/usr/Local/include -I/usr/include

To these:

 LDFLAGS += -L/usr/local/lib -L/usr/lib -levent -lz -lnoise $(LFLAGS)
 CXXFLAGS += $(DFLAGS) -I. -I/usr/Local/include -I/usr/include

This just allows us to supply some extra LDFLAGS and CXXFLAGS on the command line. Now you can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

 cd src
 CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>102416775bbc41cd41701f1087ce2cf809bf3c90</sha1>
  </revision>
  <revision>
    <id>30</id>
    <parentid>29</parentid>
    <timestamp>2010-11-29T20:33:26Z</timestamp>
    <contributor>
      <username>Mk</username>
      <id>7</id>
    </contributor>
    <comment>/* GNU/Linux */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="7875" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

Then run:
  make DEBIAN=1

====CentOS and Red Hat====

CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  cp -R include /usr/local/include/noise
  cp lib/* /usr/local/lib
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

All other dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====
You can install zlib and libevent using Macports:

 sudo port install zlib libevent

You will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that here:

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

Firstly, until batterseapowers patches are merged, you need to change these lines in src/Makefile:

 LDFLAGS = -L/usr/local/lib -L/usr/lib -levent -lz -lnoise $(LFLAGS)
 CXXFLAGS = $(DFLAGS) -I. -I/usr/Local/include -I/usr/include

To these:

 LDFLAGS += -L/usr/local/lib -L/usr/lib -levent -lz -lnoise $(LFLAGS)
 CXXFLAGS += $(DFLAGS) -I. -I/usr/Local/include -I/usr/include

This just allows us to supply some extra LDFLAGS and CXXFLAGS on the command line. Now you can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

 cd src
 CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>81f8762b2c20e47480b7e28be280aa000f39d3bc</sha1>
  </revision>
  <revision>
    <id>31</id>
    <parentid>30</parentid>
    <timestamp>2010-11-29T21:07:05Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <comment>/* Debian and Similar */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="7848" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  cp -R include /usr/local/include/noise
  cp lib/* /usr/local/lib
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

All other dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====
You can install zlib and libevent using Macports:

 sudo port install zlib libevent

You will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that here:

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

Firstly, until batterseapowers patches are merged, you need to change these lines in src/Makefile:

 LDFLAGS = -L/usr/local/lib -L/usr/lib -levent -lz -lnoise $(LFLAGS)
 CXXFLAGS = $(DFLAGS) -I. -I/usr/Local/include -I/usr/include

To these:

 LDFLAGS += -L/usr/local/lib -L/usr/lib -levent -lz -lnoise $(LFLAGS)
 CXXFLAGS += $(DFLAGS) -I. -I/usr/Local/include -I/usr/include

This just allows us to supply some extra LDFLAGS and CXXFLAGS on the command line. Now you can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

 cd src
 CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>6d488f4b86a167a8c82a35e356bdcb55485df06b</sha1>
  </revision>
  <revision>
    <id>32</id>
    <parentid>31</parentid>
    <timestamp>2010-11-29T21:09:18Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <comment>/* GNU/Linux */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="7964" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  cp -R include /usr/local/include/noise
  cp lib/* /usr/local/lib
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

All other dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====
You can install zlib and libevent using Macports:

 sudo port install zlib libevent

You will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that below.

'''NOTE'''! If you are using debian/ubuntu or similar use &lt;code&gt;make DEBIAN=1&lt;/code&gt; instead of &lt;code&gt;make&lt;/code&gt;

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

Firstly, until batterseapowers patches are merged, you need to change these lines in src/Makefile:

 LDFLAGS = -L/usr/local/lib -L/usr/lib -levent -lz -lnoise $(LFLAGS)
 CXXFLAGS = $(DFLAGS) -I. -I/usr/Local/include -I/usr/include

To these:

 LDFLAGS += -L/usr/local/lib -L/usr/lib -levent -lz -lnoise $(LFLAGS)
 CXXFLAGS += $(DFLAGS) -I. -I/usr/Local/include -I/usr/include

This just allows us to supply some extra LDFLAGS and CXXFLAGS on the command line. Now you can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

 cd src
 CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>426fe49f8d3e63a2573b3cd196af9dc33eef1952</sha1>
  </revision>
  <revision>
    <id>33</id>
    <parentid>32</parentid>
    <timestamp>2010-11-29T21:10:30Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <comment>/* OS X */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="7502" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  cp -R include /usr/local/include/noise
  cp lib/* /usr/local/lib
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

All other dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====
You can install zlib and libevent using Macports:

 sudo port install zlib libevent

You will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that below.

'''NOTE'''! If you are using debian/ubuntu or similar use &lt;code&gt;make DEBIAN=1&lt;/code&gt; instead of &lt;code&gt;make&lt;/code&gt;

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

You can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

  cd src
  CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>9e045900db976403413764aba914c93b3d216b41</sha1>
  </revision>
  <revision>
    <id>34</id>
    <parentid>33</parentid>
    <timestamp>2010-11-29T22:37:38Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>/* CentOS and Red Hat */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="7512" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  cp -R include /usr/local/include/noise
  cp lib/* /usr/local/lib
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

All other dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====
You can install zlib and libevent using Macports:

 sudo port install zlib libevent

You will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that below.

'''NOTE'''! If you are using debian/ubuntu or similar use &lt;code&gt;make DEBIAN=1&lt;/code&gt; instead of &lt;code&gt;make&lt;/code&gt;

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

You can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

  cd src
  CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>1b3ed30c41159cea32dc3df7956d2fdb3e5b890f</sha1>
  </revision>
  <revision>
    <id>35</id>
    <parentid>34</parentid>
    <timestamp>2010-11-29T22:38:22Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>/* CentOS and Red Hat */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="7515" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

Most dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

However CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  cp -R include /usr/local/include/noise
  cp lib/* /usr/local/lib
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====
You can install zlib and libevent using Macports:

 sudo port install zlib libevent

You will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that below.

'''NOTE'''! If you are using debian/ubuntu or similar use &lt;code&gt;make DEBIAN=1&lt;/code&gt; instead of &lt;code&gt;make&lt;/code&gt;

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

You can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

  cd src
  CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>70094717a53e29bb8d22ab725a7468657bc216be</sha1>
  </revision>
  <revision>
    <id>36</id>
    <parentid>35</parentid>
    <timestamp>2010-12-01T09:10:03Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>/* CentOS and Red Hat */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="7525" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

Most dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

However CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  sudo cp -R include /usr/local/include/noise
  sudo cp lib/* /usr/local/lib
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====
You can install zlib and libevent using Macports:

 sudo port install zlib libevent

You will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that below.

'''NOTE'''! If you are using debian/ubuntu or similar use &lt;code&gt;make DEBIAN=1&lt;/code&gt; instead of &lt;code&gt;make&lt;/code&gt;

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

You can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

  cd src
  CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>c09c3b0e85b55da049d2f9f19feeac5f65cccfae</sha1>
  </revision>
</page>
<page arvcontinue="">
  <title>Frequently Asked Questions</title>
  <ns>0</ns>
  <id>4</id>
  <revision>
    <id>13</id>
    <timestamp>2010-11-28T08:26:23Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>Created page with "; Question One  : Answer One  ; Question Two : Answer Two"</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="57" xml:space="preserve">; Question One 
: Answer One

; Question Two
: Answer Two</text>
    <sha1>266c6934ef688a1831f8cf8314238ba9081d6dc3</sha1>
  </revision>
  <revision>
    <id>41</id>
    <parentid>13</parentid>
    <timestamp>2010-12-06T20:17:05Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="213" xml:space="preserve">; Isn't it illegal to copy Notch's code?!
: We have created this software without decompiling the original codes. It's also a bit different in some ways. We only use the same protocol.

; Question Two
: Answer Two</text>
    <sha1>40299db0e49a21db9fe1c59127f708ea47bfa9c2</sha1>
  </revision>
</page>
<page arvcontinue="">
  <title>Commands</title>
  <ns>0</ns>
  <id>5</id>
  <revision>
    <id>18</id>
    <timestamp>2010-11-29T00:00:02Z</timestamp>
    <contributor>
      <username>Pacino</username>
      <id>6</id>
    </contributor>
    <comment>Created page with "== For all players ==  *  /players : Lists online players *  /about : Server name &amp; version *  /rules : Shows server rules *  /home : Teleports user to map spawn location *  /kit..."</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1313" xml:space="preserve">== For all players ==

*  /players : Lists online players
*  /about : Server name &amp; version
*  /rules : Shows server rules
*  /home : Teleports user to map spawn location
*  /kit (name) : Gives kit. Items for kit defined in config.cfg with kit_(name) using itemId's
*  /motd : Displays Message Of The Day

== Admin only ==
*  %text : Servermessage 
*  &amp;text : Admin-only message
*  /kick nick (kickmsg) : Kicks user with optional kick message
*  /ban nick : Bans (and kicks if online) user from server
*  /unban nick : Lift a ban
*  /save : Manually save map to disc
*  /ctp x y z : Teleport to coordinates (eg. /ctp 100 100 100)
*  /tp nick : Teleport yourself to nick's position
*  /tp nick1 nick2 : Teleport nick1 to nick2
*  /reload : Reload admins and configuration
*  /give nick id/alias (count) : Gives nick count pieces of id/alias. count = 1 is used if it is not provided. Support for over 64 items. Aliases configurable with item_alias.cfg
*  /rules nick : Shows server rules (from rules.txt) to nick
*  /gps (nick) : Without nick shows own coordinates &amp; heading. With nick shows nick's coordinates &amp; heading
*  /settime (time) : Sets server time. time = 0-24000 (0 and 24000 is day and about 15000 is night)
*  /mute nick (mutemsg) : Mutes user with optional mute message
*  /unmute nick : Unmutes user</text>
    <sha1>e325aa96174527038a8c17b0f4797d9a341fe4a0</sha1>
  </revision>
  <revision>
    <id>19</id>
    <parentid>18</parentid>
    <timestamp>2010-11-29T00:03:51Z</timestamp>
    <contributor>
      <username>Pacino</username>
      <id>6</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1364" xml:space="preserve">== For all players ==

{| class="wikitable"
|-
! Command
! Description
|-
|/players
|Lists online players
|-
|/about
|Server name &amp; version
|-
|/rules
|Shows server rules
|-
|/home
|Teleports user to map spawn location
|-
|/kit (name)
|Gives kit. Items for kit defined in config.cfg with kit_(name) using itemId's
|-
|/motd
|Displays Message Of The Day
|}

== Admin only ==
*  %text : Servermessage 
*  &amp;text : Admin-only message
*  /kick nick (kickmsg) : Kicks user with optional kick message
*  /ban nick : Bans (and kicks if online) user from server
*  /unban nick : Lift a ban
*  /save : Manually save map to disc
*  /ctp x y z : Teleport to coordinates (eg. /ctp 100 100 100)
*  /tp nick : Teleport yourself to nick's position
*  /tp nick1 nick2 : Teleport nick1 to nick2
*  /reload : Reload admins and configuration
*  /give nick id/alias (count) : Gives nick count pieces of id/alias. count = 1 is used if it is not provided. Support for over 64 items. Aliases configurable with item_alias.cfg
*  /rules nick : Shows server rules (from rules.txt) to nick
*  /gps (nick) : Without nick shows own coordinates &amp; heading. With nick shows nick's coordinates &amp; heading
*  /settime (time) : Sets server time. time = 0-24000 (0 and 24000 is day and about 15000 is night)
*  /mute nick (mutemsg) : Mutes user with optional mute message
*  /unmute nick : Unmutes user</text>
    <sha1>66ddd85de1348e3f0dabe883c954712d4a1db952</sha1>
  </revision>
  <revision>
    <id>20</id>
    <parentid>19</parentid>
    <timestamp>2010-11-29T00:08:30Z</timestamp>
    <contributor>
      <username>Pacino</username>
      <id>6</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1414" xml:space="preserve">== For all players ==
{| class="wikitable"
|-
! Command
! Description
|-
|/players
|Lists online players
|-
|/about
|Server name &amp; version
|-
|/rules
|Shows server rules
|-
|/home
|Teleports user to map spawn location
|-
|/kit (name)
|Gives kit. Items for kit defined in config.cfg with kit_(name) using itemId's
|-
|/motd
|Displays Message Of The Day
|}

== Admin only ==
{| class="wikitable"
|-
! Command
! Description
|-
|%text
|Servermessage 
|-
|&amp;text
|Admin-only message
|-
|/kick nick (kickmsg)
|Kicks user with optional kick message
|-
|/ban nick
|Bans (and kicks if online) user from server
|-
|/unban nick
|Lift a ban
|-
|/save
|Manually save map to disc
|-
|/ctp x y z
|Teleport to coordinates (eg. /ctp 100 100 100)
|-
|/tp nick
|Teleport yourself to nick's position
|-
|/tp nick1 nick2
|Teleport nick1 to nick2
|-
|/reload
|Reload admins and configuration
|-
|/give nick id/alias (count)
|Gives nick count pieces of id/alias. count = 1 is used if it is not provided. Support for over 64 items. Aliases configurable with item_alias.cfg
|-
|/rules nick
|Shows server rules (from rules.txt) to nick
|-
|/gps (nick)
|Without nick shows own coordinates &amp; heading. With nick shows nick's coordinates &amp; heading
|-
|/settime (time)
|Sets server time. time = 0-24000 (0 and 24000 is day and about 15000 is night)
|-
|/mute nick (mutemsg)
|Mutes user with optional mute message
|-
|/unmute nick
|Unmutes user
|}</text>
    <sha1>7038039643db8f66d1f81ec383b9ec6ffa4c0f07</sha1>
  </revision>
  <revision>
    <id>37</id>
    <parentid>20</parentid>
    <timestamp>2010-12-01T11:07:04Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <comment>/* For all players */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1610" xml:space="preserve">== For all players ==
{| class="wikitable"
|-
! Command
! Description
|-
|/players, /who
|Lists online players
|-
|/about
|Server name &amp; version
|-
|/rules
|Show server rules
|-
|/home
|Teleports player to map spawn location
|-
|/kit &lt;name&gt;
|Gives kit. Items for kit defined in config.cfg with kit_&lt;name&gt; using item id's
|-
|/motd
|Display Message Of The Day
|-
|/dnd
|Do Not Disturb - toggles whether the player receives chat &amp; private messages
|-
|/emote, /em, /e, /me
|Emote
|-
|/whisper, /w, /tell, /t
|Send a private message to another player
|}

== Admin only ==
{| class="wikitable"
|-
! Command
! Description
|-
|%text
|Servermessage 
|-
|&amp;text
|Admin-only message
|-
|/kick nick (kickmsg)
|Kicks user with optional kick message
|-
|/ban nick
|Bans (and kicks if online) user from server
|-
|/unban nick
|Lift a ban
|-
|/save
|Manually save map to disc
|-
|/ctp x y z
|Teleport to coordinates (eg. /ctp 100 100 100)
|-
|/tp nick
|Teleport yourself to nick's position
|-
|/tp nick1 nick2
|Teleport nick1 to nick2
|-
|/reload
|Reload admins and configuration
|-
|/give nick id/alias (count)
|Gives nick count pieces of id/alias. count = 1 is used if it is not provided. Support for over 64 items. Aliases configurable with item_alias.cfg
|-
|/rules nick
|Shows server rules (from rules.txt) to nick
|-
|/gps (nick)
|Without nick shows own coordinates &amp; heading. With nick shows nick's coordinates &amp; heading
|-
|/settime (time)
|Sets server time. time = 0-24000 (0 and 24000 is day and about 15000 is night)
|-
|/mute nick (mutemsg)
|Mutes user with optional mute message
|-
|/unmute nick
|Unmutes user
|}</text>
    <sha1>2a963268202e63cb28a74a11c5a3c8c88467caf0</sha1>
  </revision>
  <revision>
    <id>38</id>
    <parentid>37</parentid>
    <timestamp>2010-12-01T11:15:16Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <comment>/* Admin only */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1802" xml:space="preserve">== For all players ==
{| class="wikitable"
|-
! Command
! Description
|-
|/players, /who
|Lists online players
|-
|/about
|Server name &amp; version
|-
|/rules
|Show server rules
|-
|/home
|Teleports player to map spawn location
|-
|/kit &lt;name&gt;
|Gives kit. Items for kit defined in config.cfg with kit_&lt;name&gt; using item id's
|-
|/motd
|Display Message Of The Day
|-
|/dnd
|Do Not Disturb - toggles whether the player receives chat &amp; private messages
|-
|/emote, /em, /e, /me
|Emote
|-
|/whisper, /w, /tell, /t
|Send a private message to another player
|}

== Admin only ==
{| class="wikitable"
|-
! Command
! Description
|-
|%text
|Servermessage 
|-
|&amp;text
|Admin-only message
|-
|/kick &lt;player&gt; [reason]
|Kicks &lt;player&gt; with optional kick message
|-
|/ban &lt;player&gt; [reason]
|Bans (and kicks if online) &lt;player&gt; from server
|-
|/unban &lt;player&gt;
|Lift a ban
|-
|/save
|Manually save map to disc
|-
|/ctp &lt;x&gt; &lt;y&gt; &lt;z&gt;
|Teleport to coordinates (eg. /ctp 100 100 100)
|-
|/tp &lt;player&gt;
|Teleport yourself to &lt;player&gt;'s position
|-
|/tp &lt;player1&gt; &lt;player2&gt;
|Teleport &lt;player1&gt; to &lt;player2&gt;
|-
|/reload
|Reload admins and configuration
|-
|/give &lt;player&gt; &lt;id/alias&gt; [count]
|Gives &lt;player&gt; [count] pieces of &lt;id/alias&gt;. By default [count] = 1. Supports over 64 items. Aliases configurable in item_alias.cfg
|-
|/rules &lt;player&gt;
|Shows server rules (from rules.txt) to &lt;player&gt;
|-
|/gps [player] 
|Without [player] shows own coordinates &amp; heading. With [player] shows [player]'s coordinates &amp; heading
|-
|/settime &lt;time&gt;
|Sets server time. &lt;time&gt; = 0-24000 (0 and 24000 is day and about 15000 is night)
|-
|/mute &lt;player&gt; [reason]
|Mutes &lt;player&gt; with optional message
|-
|/unmute &lt;player&gt;
|Unmutes &lt;player&gt;
|-
|/regen
|Regenerates lightning
|-
|/sethealth &lt;player&gt; &lt;health&gt;
|Set &lt;player&gt;'s health. &lt;health&gt; = 0-20
|}</text>
    <sha1>591da692692a1f21dfb761556e63e9d3f73b6b83</sha1>
  </revision>
  <revision>
    <id>39</id>
    <parentid>38</parentid>
    <timestamp>2010-12-01T11:17:43Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1986" xml:space="preserve">Parameters that are marked with &lt;&gt; (example: &lt;player&gt;) are required. Parameters marked with [] (example: [reason]) are optional. Usage example: "/kick johntheminer this is test kick"

== For all players ==
{| class="wikitable"
|-
! Command
! Description
|-
|/players, /who
|Lists online players
|-
|/about
|Server name &amp; version
|-
|/rules
|Show server rules
|-
|/home
|Teleports player to map spawn location
|-
|/kit &lt;name&gt;
|Gives kit. Items for kit defined in config.cfg with kit_&lt;name&gt; using item id's
|-
|/motd
|Display Message Of The Day
|-
|/dnd
|Do Not Disturb - toggles whether the player receives chat &amp; private messages
|-
|/emote, /em, /e, /me
|Emote
|-
|/whisper, /w, /tell, /t
|Send a private message to another player
|}

== Admin only ==
{| class="wikitable"
|-
! Command
! Description
|-
|%text
|Servermessage 
|-
|&amp;text
|Admin-only message
|-
|/kick &lt;player&gt; [reason]
|Kicks &lt;player&gt; with optional kick message
|-
|/ban &lt;player&gt; [reason]
|Bans (and kicks if online) &lt;player&gt; from server
|-
|/unban &lt;player&gt;
|Lift a ban
|-
|/save
|Manually save map to disc
|-
|/ctp &lt;x&gt; &lt;y&gt; &lt;z&gt;
|Teleport to coordinates (eg. /ctp 100 100 100)
|-
|/tp &lt;player&gt;
|Teleport yourself to &lt;player&gt;'s position
|-
|/tp &lt;player1&gt; &lt;player2&gt;
|Teleport &lt;player1&gt; to &lt;player2&gt;
|-
|/reload
|Reload admins and configuration
|-
|/give &lt;player&gt; &lt;id/alias&gt; [count]
|Gives &lt;player&gt; [count] pieces of &lt;id/alias&gt;. By default [count] = 1. Supports over 64 items. Aliases configurable in item_alias.cfg
|-
|/rules &lt;player&gt;
|Shows server rules (from rules.txt) to &lt;player&gt;
|-
|/gps [player] 
|Without [player] shows own coordinates &amp; heading. With [player] shows [player]'s coordinates &amp; heading
|-
|/settime &lt;time&gt;
|Sets server time. &lt;time&gt; = 0-24000 (0 and 24000 is day and about 15000 is night)
|-
|/mute &lt;player&gt; [reason]
|Mutes &lt;player&gt; with optional message
|-
|/unmute &lt;player&gt;
|Unmutes &lt;player&gt;
|-
|/regen
|Regenerates lightning
|-
|/sethealth &lt;player&gt; &lt;health&gt;
|Set &lt;player&gt;'s health. &lt;health&gt; = 0-20
|}</text>
    <sha1>c1af71a17793c97c50a786e715c86fdec450e15d</sha1>
  </revision>
  <revision>
    <id>40</id>
    <parentid>39</parentid>
    <timestamp>2010-12-06T02:20:24Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <minor/>
    <comment>/* Admin only */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2082" xml:space="preserve">Parameters that are marked with &lt;&gt; (example: &lt;player&gt;) are required. Parameters marked with [] (example: [reason]) are optional. Usage example: "/kick johntheminer this is test kick"

== For all players ==
{| class="wikitable"
|-
! Command
! Description
|-
|/players, /who
|Lists online players
|-
|/about
|Server name &amp; version
|-
|/rules
|Show server rules
|-
|/home
|Teleports player to map spawn location
|-
|/kit &lt;name&gt;
|Gives kit. Items for kit defined in config.cfg with kit_&lt;name&gt; using item id's
|-
|/motd
|Display Message Of The Day
|-
|/dnd
|Do Not Disturb - toggles whether the player receives chat &amp; private messages
|-
|/emote, /em, /e, /me
|Emote
|-
|/whisper, /w, /tell, /t
|Send a private message to another player
|}

== Admin only ==
{| class="wikitable"
|-
! Command
! Description
|-
|%text
|Servermessage 
|-
|&amp;text
|Admin-only message
|-
|/kick &lt;player&gt; [reason]
|Kicks &lt;player&gt; with optional kick message
|-
|/ban &lt;player&gt; [reason]
|Bans (and kicks if online) &lt;player&gt; from server
|-
|/unban &lt;player&gt;
|Lift a ban
|-
|/save
|Manually save map to disc
|-
|/ctp &lt;x&gt; &lt;y&gt; &lt;z&gt;
|Teleport to coordinates (eg. /ctp 100 100 100)
|-
|/tp &lt;player&gt;
|Teleport yourself to &lt;player&gt;'s position
|-
|/tp &lt;player1&gt; &lt;player2&gt;
|Teleport &lt;player1&gt; to &lt;player2&gt;
|-
|/reload
|Reload admins and configuration
|-
|/give &lt;player&gt; &lt;id/alias&gt; [count]
|Gives &lt;player&gt; [count] pieces of &lt;id/alias&gt;. By default [count] = 1. Supports over 64 items. Aliases configurable in item_alias.cfg
|-
|/igive &lt;id/alias&gt; [count]
|Gives self [count] pieces of &lt;id/alias&gt;. By default [count] = 1.
|-
|/rules &lt;player&gt;
|Shows server rules (from rules.txt) to &lt;player&gt;
|-
|/gps [player] 
|Without [player] shows own coordinates &amp; heading. With [player] shows [player]'s coordinates &amp; heading
|-
|/settime &lt;time&gt;
|Sets server time. &lt;time&gt; = 0-24000 (0 and 24000 is day and about 15000 is night)
|-
|/mute &lt;player&gt; [reason]
|Mutes &lt;player&gt; with optional message
|-
|/unmute &lt;player&gt;
|Unmutes &lt;player&gt;
|-
|/regen
|Regenerates lightning
|-
|/sethealth &lt;player&gt; &lt;health&gt;
|Set &lt;player&gt;'s health. &lt;health&gt; = 0-20
|}</text>
    <sha1>639aee33bdde3a16585bf868d0ec5e091f8492de</sha1>
  </revision>
  <revision>
    <id>42</id>
    <parentid>40</parentid>
    <timestamp>2010-12-06T22:08:29Z</timestamp>
    <contributor>
      <username>Bakkdoor</username>
      <id>11</id>
    </contributor>
    <comment>/* Admin only */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2246" xml:space="preserve">Parameters that are marked with &lt;&gt; (example: &lt;player&gt;) are required. Parameters marked with [] (example: [reason]) are optional. Usage example: "/kick johntheminer this is test kick"

== For all players ==
{| class="wikitable"
|-
! Command
! Description
|-
|/players, /who
|Lists online players
|-
|/about
|Server name &amp; version
|-
|/rules
|Show server rules
|-
|/home
|Teleports player to map spawn location
|-
|/kit &lt;name&gt;
|Gives kit. Items for kit defined in config.cfg with kit_&lt;name&gt; using item id's
|-
|/motd
|Display Message Of The Day
|-
|/dnd
|Do Not Disturb - toggles whether the player receives chat &amp; private messages
|-
|/emote, /em, /e, /me
|Emote
|-
|/whisper, /w, /tell, /t
|Send a private message to another player
|}

== Admin only ==
{| class="wikitable"
|-
! Command
! Description
|-
|%text
|Servermessage 
|-
|&amp;text
|Admin-only message
|-
|/kick &lt;player&gt; [reason]
|Kicks &lt;player&gt; with optional kick message
|-
|/ban &lt;player&gt; [reason]
|Bans (and kicks if online) &lt;player&gt; from server
|-
|/unban &lt;player&gt;
|Lift a ban
|-
|/save
|Manually save map to disc
|-
|/ctp &lt;x&gt; &lt;y&gt; &lt;z&gt;
|Teleport to coordinates (eg. /ctp 100 100 100)
|-
|/tp &lt;player&gt;
|Teleport yourself to &lt;player&gt;'s position
|-
|/tp &lt;player1&gt; &lt;player2&gt;
|Teleport &lt;player1&gt; to &lt;player2&gt;
|-
|/reload
|Reload admins and configuration
|-
|/give &lt;player&gt; &lt;id/alias&gt; [count]
|Gives &lt;player&gt; [count] pieces of &lt;id/alias&gt;. By default [count] = 1. Supports over 64 items. Aliases configurable in item_alias.cfg
|-
|/igive &lt;id/alias&gt; [count]
|Gives self [count] pieces of &lt;id/alias&gt;. By default [count] = 1.
|-
|/rules &lt;player&gt;
|Shows server rules (from rules.txt) to &lt;player&gt;
|-
|/gps [player] 
|Without [player] shows own coordinates &amp; heading. With [player] shows [player]'s coordinates &amp; heading
|-
|/settime &lt;time&gt;
|Sets server time. &lt;time&gt; = 0-24000 (0 and 24000 is day and about 15000 is night)
|-
|/mute &lt;player&gt; [reason]
|Mutes &lt;player&gt; with optional message
|-
|/unmute &lt;player&gt;
|Unmutes &lt;player&gt;
|-
|/regen
|Regenerates lightning
|-
|/sethealth &lt;player&gt; &lt;health&gt;
|Set &lt;player&gt;'s health. &lt;health&gt; = 0-20
|
|-
|/help [&lt;commandname&gt;]
|Displays help text showing all commands and their description, or, if &lt;commandname&gt; given, displays description text for that command.
|}</text>
    <sha1>405ea7d8ce42efc029afff94df7f0ce8eb0c15bf</sha1>
  </revision>
  <revision>
    <id>43</id>
    <parentid>42</parentid>
    <timestamp>2010-12-06T22:08:54Z</timestamp>
    <contributor>
      <username>Bakkdoor</username>
      <id>11</id>
    </contributor>
    <comment>/* Admin only */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2082" xml:space="preserve">Parameters that are marked with &lt;&gt; (example: &lt;player&gt;) are required. Parameters marked with [] (example: [reason]) are optional. Usage example: "/kick johntheminer this is test kick"

== For all players ==
{| class="wikitable"
|-
! Command
! Description
|-
|/players, /who
|Lists online players
|-
|/about
|Server name &amp; version
|-
|/rules
|Show server rules
|-
|/home
|Teleports player to map spawn location
|-
|/kit &lt;name&gt;
|Gives kit. Items for kit defined in config.cfg with kit_&lt;name&gt; using item id's
|-
|/motd
|Display Message Of The Day
|-
|/dnd
|Do Not Disturb - toggles whether the player receives chat &amp; private messages
|-
|/emote, /em, /e, /me
|Emote
|-
|/whisper, /w, /tell, /t
|Send a private message to another player
|}

== Admin only ==
{| class="wikitable"
|-
! Command
! Description
|-
|%text
|Servermessage 
|-
|&amp;text
|Admin-only message
|-
|/kick &lt;player&gt; [reason]
|Kicks &lt;player&gt; with optional kick message
|-
|/ban &lt;player&gt; [reason]
|Bans (and kicks if online) &lt;player&gt; from server
|-
|/unban &lt;player&gt;
|Lift a ban
|-
|/save
|Manually save map to disc
|-
|/ctp &lt;x&gt; &lt;y&gt; &lt;z&gt;
|Teleport to coordinates (eg. /ctp 100 100 100)
|-
|/tp &lt;player&gt;
|Teleport yourself to &lt;player&gt;'s position
|-
|/tp &lt;player1&gt; &lt;player2&gt;
|Teleport &lt;player1&gt; to &lt;player2&gt;
|-
|/reload
|Reload admins and configuration
|-
|/give &lt;player&gt; &lt;id/alias&gt; [count]
|Gives &lt;player&gt; [count] pieces of &lt;id/alias&gt;. By default [count] = 1. Supports over 64 items. Aliases configurable in item_alias.cfg
|-
|/igive &lt;id/alias&gt; [count]
|Gives self [count] pieces of &lt;id/alias&gt;. By default [count] = 1.
|-
|/rules &lt;player&gt;
|Shows server rules (from rules.txt) to &lt;player&gt;
|-
|/gps [player] 
|Without [player] shows own coordinates &amp; heading. With [player] shows [player]'s coordinates &amp; heading
|-
|/settime &lt;time&gt;
|Sets server time. &lt;time&gt; = 0-24000 (0 and 24000 is day and about 15000 is night)
|-
|/mute &lt;player&gt; [reason]
|Mutes &lt;player&gt; with optional message
|-
|/unmute &lt;player&gt;
|Unmutes &lt;player&gt;
|-
|/regen
|Regenerates lightning
|-
|/sethealth &lt;player&gt; &lt;health&gt;
|Set &lt;player&gt;'s health. &lt;health&gt; = 0-20
|}</text>
    <sha1>639aee33bdde3a16585bf868d0ec5e091f8492de</sha1>
  </revision>
  <revision>
    <id>44</id>
    <parentid>43</parentid>
    <timestamp>2010-12-06T22:09:11Z</timestamp>
    <contributor>
      <username>Bakkdoor</username>
      <id>11</id>
    </contributor>
    <comment>/* For all players */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2244" xml:space="preserve">Parameters that are marked with &lt;&gt; (example: &lt;player&gt;) are required. Parameters marked with [] (example: [reason]) are optional. Usage example: "/kick johntheminer this is test kick"

== For all players ==
{| class="wikitable"
|-
! Command
! Description
|-
|/help [&lt;commandname&gt;]
|Displays help text showing all commands and their description, or, if &lt;commandname&gt; given, displays description text for that command.
|-
|/players, /who
|Lists online players
|-
|/about
|Server name &amp; version
|-
|/rules
|Show server rules
|-
|/home
|Teleports player to map spawn location
|-
|/kit &lt;name&gt;
|Gives kit. Items for kit defined in config.cfg with kit_&lt;name&gt; using item id's
|-
|/motd
|Display Message Of The Day
|-
|/dnd
|Do Not Disturb - toggles whether the player receives chat &amp; private messages
|-
|/emote, /em, /e, /me
|Emote
|-
|/whisper, /w, /tell, /t
|Send a private message to another player
|}

== Admin only ==
{| class="wikitable"
|-
! Command
! Description
|-
|%text
|Servermessage 
|-
|&amp;text
|Admin-only message
|-
|/kick &lt;player&gt; [reason]
|Kicks &lt;player&gt; with optional kick message
|-
|/ban &lt;player&gt; [reason]
|Bans (and kicks if online) &lt;player&gt; from server
|-
|/unban &lt;player&gt;
|Lift a ban
|-
|/save
|Manually save map to disc
|-
|/ctp &lt;x&gt; &lt;y&gt; &lt;z&gt;
|Teleport to coordinates (eg. /ctp 100 100 100)
|-
|/tp &lt;player&gt;
|Teleport yourself to &lt;player&gt;'s position
|-
|/tp &lt;player1&gt; &lt;player2&gt;
|Teleport &lt;player1&gt; to &lt;player2&gt;
|-
|/reload
|Reload admins and configuration
|-
|/give &lt;player&gt; &lt;id/alias&gt; [count]
|Gives &lt;player&gt; [count] pieces of &lt;id/alias&gt;. By default [count] = 1. Supports over 64 items. Aliases configurable in item_alias.cfg
|-
|/igive &lt;id/alias&gt; [count]
|Gives self [count] pieces of &lt;id/alias&gt;. By default [count] = 1.
|-
|/rules &lt;player&gt;
|Shows server rules (from rules.txt) to &lt;player&gt;
|-
|/gps [player] 
|Without [player] shows own coordinates &amp; heading. With [player] shows [player]'s coordinates &amp; heading
|-
|/settime &lt;time&gt;
|Sets server time. &lt;time&gt; = 0-24000 (0 and 24000 is day and about 15000 is night)
|-
|/mute &lt;player&gt; [reason]
|Mutes &lt;player&gt; with optional message
|-
|/unmute &lt;player&gt;
|Unmutes &lt;player&gt;
|-
|/regen
|Regenerates lightning
|-
|/sethealth &lt;player&gt; &lt;health&gt;
|Set &lt;player&gt;'s health. &lt;health&gt; = 0-20
|}</text>
    <sha1>d5e2ebb49497b251fa1603fef61db2c61d74d2ee</sha1>
  </revision>
</page>
<page arvcontinue="">
  <title>Coding Style</title>
  <ns>0</ns>
  <id>6</id>
  <revision>
    <id>46</id>
    <timestamp>2010-12-06T22:19:05Z</timestamp>
    <contributor>
      <username>Bakkdoor</username>
      <id>11</id>
    </contributor>
    <comment>Created page with "This is a suggestion for a coding style to be used consistently accross Mineserver's source code.  * '''Indentation''': 2 spaces * '''Class names''': Camelcase, starting with upp..."</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="521" xml:space="preserve">This is a suggestion for a coding style to be used consistently accross Mineserver's source code.

* '''Indentation''': 2 spaces
* '''Class names''': Camelcase, starting with uppercase letter, e.g.: '''FurnaceManager'''
* '''Variable and method names''': Camelcase, starting with lowercase letter, e.g.: '''updateWorld()''', '''userCommands'''.
** For loop variables short-names are ok, e.g. '''i''', '''j'''. Otherwise use descriptive names and don't use abbreviations all over the place, to make the code more readable.</text>
    <sha1>8d784dccb96b0366e53c7be13f66c8957e8ddc2c</sha1>
  </revision>
  <revision>
    <id>47</id>
    <parentid>46</parentid>
    <timestamp>2010-12-06T22:19:31Z</timestamp>
    <contributor>
      <username>Bakkdoor</username>
      <id>11</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="526" xml:space="preserve">This is a suggestion for a coding style to be used consistently accross Mineserver's source code.

* '''Indentation''': 2 spaces
* '''Class names''': Camelcase, starting with uppercase letter, e.g.: '''FurnaceManager'''
* '''Variable and method names''': Camelcase, starting with lowercase letter, e.g.: '''updateWorld()''', '''userCommands'''.
** Using short names for loop variables is ok, e.g. '''i''', '''j'''. Otherwise use descriptive names and don't use abbreviations all over the place, to make the code more readable.</text>
    <sha1>3dac05747efed8631f010ae5049af87e64251e69</sha1>
  </revision>
  <revision>
    <id>48</id>
    <parentid>47</parentid>
    <timestamp>2010-12-06T22:27:42Z</timestamp>
    <contributor>
      <username>Bakkdoor</username>
      <id>11</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="989" xml:space="preserve">This is a suggestion for a coding style to be used consistently accross Mineserver's source code.

* '''Indentation''': 2 spaces
* '''Class names''': Camelcase, starting with uppercase letter, e.g.: '''FurnaceManager'''
* '''Variable and method names''': Camelcase, starting with lowercase letter, e.g.: '''updateWorld()''', '''userCommands'''.
** Using short names for loop variables is ok, e.g. '''i''', '''j'''. Otherwise use descriptive names and don't use abbreviations all over the place, to make the code more readable.
* '''Inline methods''': Keep them short (max 10-15 lines at most).
* '''Documentation''': Use javadoc-style documentation for at least all public methods. Example:
    /**
     * The foo() method. Does some fooish stuff, yo!
     * @param bar Bar instance to be used in foo().
     * @return An instance of Baz that does something fantastic!
     */
     Baz* Foo::foo(Bar* bar);
** Note: Documentation should go in to the header file.
* '''Class definitions''':</text>
    <sha1>ab7fdfdf2797acf65d0f3f504097d7a40e7b31b3</sha1>
  </revision>
  <revision>
    <id>49</id>
    <parentid>48</parentid>
    <timestamp>2010-12-06T22:29:15Z</timestamp>
    <contributor>
      <username>Bakkdoor</username>
      <id>11</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1062" xml:space="preserve">This is a suggestion for a coding style to be used consistently accross Mineserver's source code.

* '''Indentation''': 2 spaces
* '''Class names''': Camelcase, starting with uppercase letter, e.g.: '''FurnaceManager'''
* '''Variable and method names''': Camelcase, starting with lowercase letter, e.g.: '''updateWorld()''', '''userCommands'''.
** '''Pointer variables''': Use '''Foo* bar''' instead of '''Foo *bar'''
** Using short names for loop variables is ok, e.g. '''i''', '''j'''. Otherwise use descriptive names and don't use abbreviations all over the place, to make the code more readable.
* '''Inline methods''': Keep them short (max 10-15 lines at most).
* '''Documentation''': Use javadoc-style documentation for at least all public methods. Example:
    /**
     * The foo() method. Does some fooish stuff, yo!
     * @param bar Bar instance to be used in foo().
     * @return An instance of Baz that does something fantastic!
     */
     Baz* Foo::foo(Bar* bar);
** Note: Documentation should go in to the header file.
* '''Class definitions''':</text>
    <sha1>20f1170abcf21144f5395a8521b434cff840449a</sha1>
  </revision>
  <revision>
    <id>50</id>
    <parentid>49</parentid>
    <timestamp>2010-12-06T22:31:53Z</timestamp>
    <contributor>
      <username>Bakkdoor</username>
      <id>11</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1563" xml:space="preserve">This is a suggestion for a coding style to be used consistently accross Mineserver's source code.

* '''Indentation''': 2 spaces
* '''Class names''': Camelcase, starting with uppercase letter, e.g.: '''FurnaceManager'''
* '''Variable and method names''': Camelcase, starting with lowercase letter, e.g.: '''updateWorld()''', '''userCommands'''.
** '''Pointer variables''': Use '''Foo* bar''' instead of '''Foo *bar'''
** Using short names for loop variables is ok, e.g. '''i''', '''j'''. Otherwise use descriptive names and don't use abbreviations all over the place, to make the code more readable.
* '''Inline methods''': Keep them short (max 10-15 lines at most).
* '''Documentation''': Use javadoc-style documentation for at least all public methods. Example:
    /**
     * The foo() method. Does some fooish stuff, yo!
     * @param bar Bar instance to be used in foo().
     * @return An instance of Baz that does something fantastic!
     */
     Baz* Foo::foo(Bar* bar);
** Note: Documentation should go in to the header file.
* '''Class definitions''': Put public methods at the top of the definition. They're usually the most interesting part from a user's point of view. Private stuff at the bottom.
    class Foo {
      public:
      Foo();
      ~Foo();
    
      /**
       * The foo() method. Does some fooish stuff, yo!
       * @param bar Bar instance to be used in foo().
       * @return An instance of Baz that does something fantastic!
       */
      Baz* foo(Bar* bar);

      private:
      /* private instance vars etc go here.*/
    }</text>
    <sha1>9553e7c6342232095eb0caa3402ad5e6968cfad3</sha1>
  </revision>
</page>
<page arvcontinue="20101206223208|51">
  <title>Coding Style</title>
  <ns>0</ns>
  <id>6</id>
  <revision>
    <id>51</id>
    <parentid>50</parentid>
    <timestamp>2010-12-06T22:32:08Z</timestamp>
    <contributor>
      <username>Bakkdoor</username>
      <id>11</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1569" xml:space="preserve">This is a suggestion for a coding style to be used consistently accross Mineserver's source code.

* '''Indentation''': 2 spaces
* '''Class names''': Camelcase, starting with uppercase letter, e.g.: '''FurnaceManager'''
* '''Variable and method names''': Camelcase, starting with lowercase letter, e.g.: '''updateWorld()''', '''userCommands'''.
** '''Pointer variables''': Use '''Foo* bar''' instead of '''Foo *bar'''
** Using short names for loop variables is ok, e.g. '''i''', '''j'''. Otherwise use descriptive names and don't use abbreviations all over the place, to make the code more readable.
* '''Inline methods''': Keep them short (max 10-15 lines at most).
* '''Documentation''': Use javadoc-style documentation for at least all public methods. Example:
    /**
     * The foo() method. Does some fooish stuff, yo!
     * @param bar Bar instance to be used in foo().
     * @return An instance of Baz that does something fantastic!
     */
     Baz* Foo::foo(Bar* bar);
** Note: Documentation should go in to the header file.
* '''Class definitions''': Put public methods at the top of the definition. They're usually the most interesting part from a user's point of view. Private stuff at the bottom.
    class Foo {
      public:
      Foo();
      ~Foo();
    
      /**
       * The foo() method. Does some fooish stuff, yo!
       * @param bar Bar instance to be used in foo().
       * @return An instance of Baz that does something fantastic!
       */
      Baz* foo(Bar* bar);
      
      private:
      /* private instance vars etc go here.*/
    }</text>
    <sha1>4a56f84fe566706580e0bd6446649aa1e4bbd853</sha1>
  </revision>
  <revision>
    <id>52</id>
    <parentid>51</parentid>
    <timestamp>2010-12-06T22:32:31Z</timestamp>
    <contributor>
      <username>Bakkdoor</username>
      <id>11</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1618" xml:space="preserve">This is a suggestion for a coding style to be used consistently accross Mineserver's source code.

* '''Indentation''': 2 spaces
* '''Class names''': Camelcase, starting with uppercase letter, e.g.: '''FurnaceManager'''
* '''Variable and method names''': Camelcase, starting with lowercase letter, e.g.: '''updateWorld()''', '''userCommands'''.
** '''Pointer variables''': Use '''Foo* bar''' instead of '''Foo *bar'''
** Using short names for loop variables is ok, e.g. '''i''', '''j'''. Otherwise use descriptive names and don't use abbreviations all over the place, to make the code more readable.
* '''Inline methods''': Keep them short (max 10-15 lines at most).
* '''Documentation''': Use javadoc-style documentation for at least all public methods. Example:
    /**
     * The foo() method. Does some fooish stuff, yo!
     * @param bar Bar instance to be used in foo().
     * @return An instance of Baz that does something fantastic!
     */
     Baz* Foo::foo(Bar* bar);
** Note: Documentation should go in to the header file.
* '''Class definitions''': Put public methods at the top of the definition. They're usually the most interesting part from a user's point of view. Private stuff at the bottom.
    class Foo {
      public:
      Foo();
      ~Foo();
    
      /**
       * The foo() method. Does some fooish stuff, yo!
       * @param bar Bar instance to be used in foo().
       * @return An instance of Baz that does something fantastic!
       */
      Baz* foo(Bar* bar);
      
      private:
      /* private instance vars etc go here.*/
    }
* '''Namespaces''': We probably should use them.</text>
    <sha1>2087dc18d353aaac1506cf08f5ef05b5e8961c66</sha1>
  </revision>
  <revision>
    <id>53</id>
    <parentid>52</parentid>
    <timestamp>2010-12-06T22:36:52Z</timestamp>
    <contributor>
      <username>Bakkdoor</username>
      <id>11</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2059" xml:space="preserve">This is a suggestion for a coding style to be used consistently accross Mineserver's source code.

* '''Indentation''': 2 spaces
* '''Class names''': Camelcase, starting with uppercase letter, e.g.: '''FurnaceManager'''
* '''Variable and method names''': Camelcase, starting with lowercase letter, e.g.: '''updateWorld()''', '''userCommands'''.
** '''Pointer variables''': Use '''Foo* bar''' instead of '''Foo *bar'''
** Using short names for loop variables is ok, e.g. '''i''', '''j'''. Otherwise use descriptive names and don't use abbreviations all over the place, to make the code more readable.
* '''Inline methods''': Keep them short (max 10-15 lines at most).
* '''Documentation''': Use javadoc-style documentation for at least all public methods. Example:
    /**
     * The foo() method. Does some fooish stuff, yo!
     * @param bar Bar instance to be used in foo().
     * @return An instance of Baz that does something fantastic!
     */
     Baz* Foo::foo(Bar* bar);
** Note: Documentation should go in to the header file.
* '''Class definitions''': Put public methods at the top of the definition. They're usually the most interesting part from a user's point of view. Private stuff at the bottom.
    class Foo {
      public:
      Foo();
      ~Foo();
    
      /**
       * The foo() method. Does some fooish stuff, yo!
       * @param bar Bar instance to be used in foo().
       * @return An instance of Baz that does something fantastic!
       */
      Baz* foo(Bar* bar);
      
      private:
      /* private instance vars etc go here.*/
    }
** '''Instance variables''' should usually be accessible through getter and setter methods and thus be private. In some cases having them public is fine. Also, don't use prefixes for public instance variables, since it's ugly to use. For private instance varibles we could choose to use either '''_foo''', '''m_foo''', '''mFoo''' etc. I personally prefer '''_foo''' and have a getter method be just '''foo()''' and a setter '''setFoo()'''. 
* '''Namespaces''': We probably should use them.</text>
    <sha1>5c7a7afecbddb907250423d070dff6f1199df338</sha1>
  </revision>
  <revision>
    <id>54</id>
    <parentid>53</parentid>
    <timestamp>2010-12-06T22:39:06Z</timestamp>
    <contributor>
      <username>Bakkdoor</username>
      <id>11</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2237" xml:space="preserve">This is a suggestion for a coding style to be used consistently accross Mineserver's source code.

* '''Indentation''': 2 spaces
* '''Class names''': Camelcase, starting with uppercase letter, e.g.: '''FurnaceManager'''
* '''Variable and method names''': Camelcase, starting with lowercase letter, e.g.: '''updateWorld()''', '''userCommands'''.
** '''Pointer variables''': Use '''Foo* bar''' instead of '''Foo *bar'''
** Using short names for loop variables is ok, e.g. '''i''', '''j'''. Otherwise use descriptive names and don't use abbreviations all over the place, to make the code more readable.
* '''Inline methods''': Keep them short (max 10-15 lines at most).
* '''Documentation''': Use javadoc-style documentation for at least all public methods. Example:
    /**
     * The foo() method. Does some fooish stuff, yo!
     * @param bar Bar instance to be used in foo().
     * @return An instance of Baz that does something fantastic!
     */
     Baz* Foo::foo(Bar* bar);
** Note: Documentation should go in to the header file.
* '''Class definitions''': Put public methods at the top of the definition. They're usually the most interesting part from a user's point of view. Private stuff at the bottom.
    class Foo {
      public:
      Foo();
      ~Foo();
    
      /**
       * The foo() method. Does some fooish stuff, yo!
       * @param bar Bar instance to be used in foo().
       * @return An instance of Baz that does something fantastic!
       */
      Baz* foo(Bar* bar);
      
      private:
      /* private instance vars etc go here.*/
    }
** '''Instance variables''' should usually be accessible through getter and setter methods and thus be private. In some cases having them public is fine (e.g. when they're accessed all over the place and modifiying them happens all over the place as well. Usually this is the case for "dumb classes" used as pure data structures). Also, don't use prefixes for public instance variables, since it's ugly to use. For private instance variables we could choose to use either '''_foo''', '''m_foo''', '''mFoo''' etc. I personally prefer '''_foo''' and have a getter method be just '''foo()''' and a setter '''setFoo()'''. 
* '''Namespaces''': We probably should use them.</text>
    <sha1>9970aefb16ab32ee4c16ce963c9bf67de568f1e5</sha1>
  </revision>
  <revision>
    <id>55</id>
    <parentid>54</parentid>
    <timestamp>2010-12-06T22:39:27Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2349" xml:space="preserve">This is a suggestion for a coding style to be used consistently accross Mineserver's source code.

* '''Indentation''': 2 spaces
* '''Class names''': Camelcase, starting with uppercase letter, e.g.: '''FurnaceManager'''
* '''Variable and method names''': Camelcase, starting with lowercase letter, e.g.: '''updateWorld()''', '''userCommands'''.
** '''Pointer variables''': Use '''Foo* bar''' instead of '''Foo *bar'''
** Using short names for loop variables is ok, e.g. '''i''', '''j'''. Otherwise use descriptive names and don't use abbreviations all over the place, to make the code more readable.
* '''Inline methods''': Keep them short (max 10-15 lines at most).
* '''Documentation''': Use javadoc-style documentation for at least all public methods. Example:
    /**
     * The foo() method. Does some fooish stuff, yo!
     * @param bar Bar instance to be used in foo().
     * @return An instance of Baz that does something fantastic!
     */
     Baz* Foo::foo(Bar* bar);
** Note: Documentation should go in to the header file.
* '''Class definitions''': Put public methods at the top of the definition. They're usually the most interesting part from a user's point of view. Private stuff at the bottom.
    class Foo {
      public:
      Foo();
      ~Foo();
    
      /**
       * The foo() method. Does some fooish stuff, yo!
       * @param bar Bar instance to be used in foo().
       * @return An instance of Baz that does something fantastic!
       */
      Baz* foo(Bar* bar);
      
      private:
      /* private instance vars etc go here.*/
    }
** '''Instance variables''' should usually be accessible through getter and setter methods and thus be private. In some cases having them public is fine (e.g. when they're accessed all over the place and modifiying them happens all over the place as well. Usually this is the case for "dumb classes" used as pure data structures). Also, don't use prefixes for public instance variables, since it's ugly to use. For private instance variables we could choose to use either '''_foo''', '''m_foo''', '''mFoo''' etc. I personally prefer '''_foo''' and have a getter method be just '''foo()''' and a setter '''setFoo()'''. 
* '''Namespaces''': We probably should use them.
* '''Codeblocks''':
    if(true)
      foo = bar;

    if(true)
    {
      foo = bar;
      foo2 = bar2;
    }</text>
    <sha1>408369f7351d87bcba2f4e60f4b76a2bb59735b0</sha1>
  </revision>
  <revision>
    <id>56</id>
    <parentid>55</parentid>
    <timestamp>2010-12-06T22:39:49Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2354" xml:space="preserve">This is a suggestion for a coding style to be used consistently accross Mineserver's source code.

* '''Indentation''': 2 spaces
* '''Class names''': Camelcase, starting with uppercase letter, e.g.: '''FurnaceManager'''
* '''Variable and method names''': Camelcase, starting with lowercase letter, e.g.: '''updateWorld()''', '''userCommands'''.
** '''Pointer variables''': Use '''Foo* bar''' instead of '''Foo *bar'''
** Using short names for loop variables is ok, e.g. '''i''', '''j'''. Otherwise use descriptive names and don't use abbreviations all over the place, to make the code more readable.
* '''Inline methods''': Keep them short (max 10-15 lines at most).
* '''Documentation''': Use javadoc-style documentation for at least all public methods. Example:
    /**
     * The foo() method. Does some fooish stuff, yo!
     * @param bar Bar instance to be used in foo().
     * @return An instance of Baz that does something fantastic!
     */
     Baz* Foo::foo(Bar* bar);
** Note: Documentation should go in to the header file.
* '''Class definitions''': Put public methods at the top of the definition. They're usually the most interesting part from a user's point of view. Private stuff at the bottom.
    class Foo 
    {
      public:
      Foo();
      ~Foo();
    
      /**
       * The foo() method. Does some fooish stuff, yo!
       * @param bar Bar instance to be used in foo().
       * @return An instance of Baz that does something fantastic!
       */
      Baz* foo(Bar* bar);
      
      private:
      /* private instance vars etc go here.*/
    }
** '''Instance variables''' should usually be accessible through getter and setter methods and thus be private. In some cases having them public is fine (e.g. when they're accessed all over the place and modifiying them happens all over the place as well. Usually this is the case for "dumb classes" used as pure data structures). Also, don't use prefixes for public instance variables, since it's ugly to use. For private instance variables we could choose to use either '''_foo''', '''m_foo''', '''mFoo''' etc. I personally prefer '''_foo''' and have a getter method be just '''foo()''' and a setter '''setFoo()'''. 
* '''Namespaces''': We probably should use them.
* '''Codeblocks''':
    if(true)
      foo = bar;

    if(true)
    {
      foo = bar;
      foo2 = bar2;
    }</text>
    <sha1>4078c0e60a655d1fc5f02ad90c97f89392d9d398</sha1>
  </revision>
  <revision>
    <id>57</id>
    <parentid>56</parentid>
    <timestamp>2010-12-06T22:40:15Z</timestamp>
    <contributor>
      <username>Bakkdoor</username>
      <id>11</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2420" xml:space="preserve">This is a suggestion for a coding style to be used consistently accross Mineserver's source code.

* '''Indentation''': 2 spaces
* '''Class names''': Camelcase, starting with uppercase letter, e.g.: '''FurnaceManager'''
* '''Variable and method names''': Camelcase, starting with lowercase letter, e.g.: '''updateWorld()''', '''userCommands'''.
** '''Pointer variables''': Use '''Foo* bar''' instead of '''Foo *bar'''
** Using short names for loop variables is ok, e.g. '''i''', '''j'''. Otherwise use descriptive names and don't use abbreviations all over the place, to make the code more readable.
* '''Inline methods''': Keep them short (max 10-15 lines at most).
* '''Documentation''': Use javadoc-style documentation for at least all public methods. Example:
    /**
     * The foo() method. Does some fooish stuff, yo!
     * @param bar Bar instance to be used in foo().
     * @return An instance of Baz that does something fantastic!
     */
     Baz* Foo::foo(Bar* bar);
** Note: Documentation should go in to the header file.
* '''Class definitions''': Put public methods at the top of the definition. They're usually the most interesting part from a user's point of view. Private stuff at the bottom.
    class Foo 
    {
      public:
      Foo();
      ~Foo();
    
      /**
       * The foo() method. Does some fooish stuff, yo!
       * @param bar Bar instance to be used in foo().
       * @return An instance of Baz that does something fantastic!
       */
      Baz* foo(Bar* bar);
      
      private:
      /* private instance vars etc go here.*/
    }
** '''Instance variables''' should usually be accessible through getter and setter methods and thus be private. In some cases having them public is fine (e.g. when they're accessed all over the place and modifiying them happens all over the place as well. Usually this is the case for "dumb classes" used as pure data structures. We should consider using a '''struct''' instead for these cases.). Also, don't use prefixes for public instance variables, since it's ugly to use. For private instance variables we could choose to use either '''_foo''', '''m_foo''', '''mFoo''' etc. I personally prefer '''_foo''' and have a getter method be just '''foo()''' and a setter '''setFoo()'''. 
* '''Namespaces''': We probably should use them.
* '''Codeblocks''':
    if(true)
      foo = bar;

    if(true)
    {
      foo = bar;
      foo2 = bar2;
    }</text>
    <sha1>9cd45e39c8ec02479fac51782ec72cce03f54180</sha1>
  </revision>
  <revision>
    <id>58</id>
    <parentid>57</parentid>
    <timestamp>2010-12-06T22:41:11Z</timestamp>
    <contributor>
      <username>Bakkdoor</username>
      <id>11</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2421" xml:space="preserve">This is a suggestion for a coding style to be used consistently accross Mineserver's source code.

* '''Indentation''': 2 spaces
* '''Class names''': Camelcase, starting with uppercase letter, e.g.: '''FurnaceManager'''
* '''Variable and method names''': Camelcase, starting with lowercase letter, e.g.: '''updateWorld()''', '''userCommands'''.
** '''Pointer variables''': Use '''Foo* bar''' instead of '''Foo *bar'''
** Using short names for loop variables is ok, e.g. '''i''', '''j'''. Otherwise use descriptive names and don't use abbreviations all over the place, to make the code more readable.
* '''Inline methods''': Keep them short (max 10-15 lines at most).
* '''Documentation''': Use javadoc-style documentation for at least all public methods. Example:
    /**
     * The foo() method. Does some fooish stuff, yo!
     * @param bar Bar instance to be used in foo().
     * @return An instance of Baz that does something fantastic!
     */
     Baz* Foo::foo(Bar* bar);
** Note: Documentation should go in to the header file.
* '''Class definitions''': Put public methods at the top of the definition. They're usually the most interesting part from a user's point of view. Private stuff at the bottom.
    class Foo 
    {
      public:
      Foo();
      ~Foo();
    
      /**
       * The foo() method. Does some fooish stuff, yo!
       * @param bar Bar instance to be used in foo().
       * @return An instance of Baz that does something fantastic!
       */
      Baz* foo(Bar* bar);
      
      private:
      /* private instance vars etc go here.*/
    };
** '''Instance variables''' should usually be accessible through getter and setter methods and thus be private. In some cases having them public is fine (e.g. when they're accessed all over the place and modifiying them happens all over the place as well. Usually this is the case for "dumb classes" used as pure data structures. We should consider using a '''struct''' instead for these cases.). Also, don't use prefixes for public instance variables, since it's ugly to use. For private instance variables we could choose to use either '''_foo''', '''m_foo''', '''mFoo''' etc. I personally prefer '''_foo''' and have a getter method be just '''foo()''' and a setter '''setFoo()'''. 
* '''Namespaces''': We probably should use them.
* '''Codeblocks''':
    if(true)
      foo = bar;

    if(true)
    {
      foo = bar;
      foo2 = bar2;
    }</text>
    <sha1>b87cab40eb506227496aa1b88ef334cde10107fa</sha1>
  </revision>
  <revision>
    <id>59</id>
    <parentid>58</parentid>
    <timestamp>2010-12-06T22:41:49Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2527" xml:space="preserve">This is a suggestion for a coding style to be used consistently accross Mineserver's source code.

* '''Indentation''': 2 spaces
* '''Class names''': Camelcase, starting with uppercase letter, e.g.: '''FurnaceManager'''
* '''Variable and method names''': Camelcase, starting with lowercase letter, e.g.: '''updateWorld()''', '''userCommands'''.
** '''Pointer variables''': Use '''Foo* bar''' instead of '''Foo *bar'''
** Using short names for loop variables is ok, e.g. '''i''', '''j'''. Otherwise use descriptive names and don't use abbreviations all over the place, to make the code more readable.
* '''Inline methods''': Keep them short (max 10-15 lines at most).
* '''Documentation''': Use javadoc-style documentation for at least all public methods. Example:
    /**
     * The foo() method. Does some fooish stuff, yo!
     * @param bar Bar instance to be used in foo().
     * @return An instance of Baz that does something fantastic!
     */
     Baz* Foo::foo(Bar* bar);
** Note: Documentation should go in to the header file.
* '''Class definitions''': Put public methods at the top of the definition. They're usually the most interesting part from a user's point of view. Private stuff at the bottom.
    class Foo 
    {
      public:
      Foo();
      ~Foo();
    
      /**
       * The foo() method. Does some fooish stuff, yo!
       * @param bar Bar instance to be used in foo().
       * @return An instance of Baz that does something fantastic!
       */
      Baz* foo(Bar* bar);
      
      private:
      /* private instance vars etc go here.*/
    };
** '''Instance variables''' should usually be accessible through getter and setter methods and thus be private. In some cases having them public is fine (e.g. when they're accessed all over the place and modifiying them happens all over the place as well. Usually this is the case for "dumb classes" used as pure data structures. We should consider using a '''struct''' instead for these cases.). Also, don't use prefixes for public instance variables, since it's ugly to use. For private instance variables we could choose to use either '''_foo''', '''m_foo''', '''mFoo''' etc. I personally prefer '''_foo''' and have a getter method be just '''foo()''' and a setter '''setFoo()'''. 
* '''Namespaces''': We probably should use them.
* '''Codeblocks''':
    if(true)
      foo = bar;
    
    if(true)
    {
      foo = bar;
      foo2 = bar2;
    }
* '''Spacing''':
    fooBar(param1, param2, param3);
    for(int i = 0; i &lt; 1; i++)
    {
     
    }</text>
    <sha1>88ee90e0de81a21a5609cc4598b1f83591e442f3</sha1>
  </revision>
  <revision>
    <id>60</id>
    <parentid>59</parentid>
    <timestamp>2010-12-06T22:53:02Z</timestamp>
    <contributor>
      <username>Bakkdoor</username>
      <id>11</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2553" xml:space="preserve">This is a suggestion for a coding style to be used consistently accross Mineserver's source code.

* '''Indentation''': 2 spaces
* '''Class names''': Camelcase, starting with uppercase letter, e.g.: '''FurnaceManager'''
* '''Variable and method names''': Camelcase, starting with lowercase letter, e.g.: '''updateWorld()''', '''userCommands'''.
** '''Pointer variables''': Use '''Foo* bar''' instead of '''Foo *bar'''
** Using short names for loop variables is ok, e.g. '''i''', '''j'''. Otherwise use descriptive names and don't use abbreviations all over the place, to make the code more readable.
* '''Inline methods''': Keep them short (max 10-15 lines at most).
* '''Documentation''': Use javadoc-style documentation for at least all public methods. Example:
    /**
     * The foo() method. Does some fooish stuff, yo!
     * @param bar Bar instance to be used in foo().
     * @return An instance of Baz that does something fantastic!
     */
     Baz* Foo::foo(Bar* bar);
** Note: Documentation should go in to the header file.
* '''Class definitions''': Put public methods at the top of the definition. They're usually the most interesting part from a user's point of view. Private stuff at the bottom.
    class Foo 
    {
      public:
      Foo();
      ~Foo();
    
      /**
       * The foo() method. Does some fooish stuff, yo!
       * @param bar Bar instance to be used in foo().
       * @return An instance of Baz that does something fantastic!
       */
      Baz* foo(Bar* bar);
      
      private:
      /* private instance vars etc go here.*/
    };
** '''Instance variables''' should usually be accessible through getter and setter methods and thus be private. In some cases having them public is fine (e.g. when they're accessed all over the place and modifiying them happens all over the place as well. Usually this is the case for "dumb classes" used as pure data structures. We should consider using a '''struct''' instead for these cases.). Also, don't use prefixes for public instance variables, since it's ugly to use. For private instance variables we could choose to use either '''_foo''', '''m_foo''', '''mFoo''' etc. I personally prefer '''_foo''' and have a getter method be just '''foo()''' and a setter '''setFoo()'''. 
* '''Namespaces''': We probably should use them.
* '''Codeblocks''':
    if(true)
      foo = bar;
    
    if(true)
    {
      foo = bar;
      foo2 = bar2;
    }
* '''Spacing''':
    Foo* bar = new Foo();
    fooBar(param1, param2, param3);
    for(int i = 0; i &lt; 1; i++)
    {
     
    }</text>
    <sha1>9c3ef52c2779decbe0533709065882e27cc818c8</sha1>
  </revision>
  <revision>
    <id>63</id>
    <parentid>60</parentid>
    <timestamp>2010-12-07T09:55:51Z</timestamp>
    <contributor>
      <username>Bakkdoor</username>
      <id>11</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2486" xml:space="preserve">This is a suggestion for a coding style to be used consistently accross Mineserver's source code.

* '''Indentation''': 2 spaces
* '''Class names''': Camelcase, starting with uppercase letter, e.g.: '''FurnaceManager'''
* '''Variable and method names''': Camelcase, starting with lowercase letter, e.g.: '''updateWorld()''', '''userCommands'''.
** '''Pointer variables''': Use '''Foo* bar''' instead of '''Foo *bar'''
** Using short names for loop variables is ok, e.g. '''i''', '''j'''. Otherwise use descriptive names and don't use abbreviations all over the place, to make the code more readable.
* '''Inline methods''': Keep them short (max 10-15 lines at most).
* '''Documentation''': Use javadoc-style documentation for at least all public methods. Example:
    /**
     * The foo() method. Does some fooish stuff, yo!
     * @param bar Bar instance to be used in foo().
     * @return An instance of Baz that does something fantastic!
     */
     Baz* Foo::foo(Bar* bar);
** Note: Documentation should go in to the header file.
* '''Class definitions''': Put public methods at the top of the definition. They're usually the most interesting part from a user's point of view. Private stuff at the bottom.
    class Foo 
    {
      public:
      Foo();
      ~Foo();
    
      /**
       * The foo() method. Does some fooish stuff, yo!
       * @param bar Bar instance to be used in foo().
       * @return An instance of Baz that does something fantastic!
       */
      Baz* foo(Bar* bar);
      
      private:
      /* private instance vars etc go here.*/
    };
** '''Instance variables''' should usually be accessible through getter and setter methods and thus be private. In some cases having them public is fine (e.g. when they're accessed all over the place and modifiying them happens all over the place as well. Usually this is the case for "dumb classes" used as pure data structures. We should consider using a '''struct''' instead for these cases.). Also, don't use prefixes for public instance variables, since it's ugly to use. For private instance variables we could choose to use '''m_foo''' and have a getter method be just '''foo()''' and a setter '''setFoo()'''. 
* '''Namespaces''': We probably should use them.
* '''Codeblocks''':
    if(true)
      foo = bar;
    
    if(true)
    {
      foo = bar;
      foo2 = bar2;
    }
* '''Spacing''':
    Foo* bar = new Foo();
    fooBar(param1, param2, param3);
    for(int i = 0; i &lt; 1; i++)
    {
     
    }</text>
    <sha1>fc43f21eb1f7cd85eb0211c8f0272d35f8bf3e98</sha1>
  </revision>
  <revision>
    <id>64</id>
    <parentid>63</parentid>
    <timestamp>2010-12-07T10:00:57Z</timestamp>
    <contributor>
      <username>Bakkdoor</username>
      <id>11</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2561" xml:space="preserve">This is a suggestion for a coding style to be used consistently accross Mineserver's source code.

* '''Indentation''': 2 spaces
* '''Class names''': Camelcase, starting with uppercase letter, e.g.: '''FurnaceManager'''
* '''Variable and method names''': Camelcase, starting with lowercase letter, e.g.: '''updateWorld()''', '''userCommands'''.
** '''Pointer variables''': Use '''Foo* bar''' instead of '''Foo *bar'''
** Using short names for loop variables is ok, e.g. '''i''', '''j'''. Otherwise use descriptive names and don't use abbreviations all over the place, to make the code more readable.
* '''Inline methods''': Keep them short (max 10-15 lines at most).
* '''Documentation''': Use javadoc-style documentation for at least all public methods. Example:
    /**
     * The foo() method. Does some fooish stuff, yo!
     * @param bar Bar instance to be used in foo().
     * @return An instance of Baz that does something fantastic!
     */
     Baz* Foo::foo(Bar* bar);
** Note: Documentation should go in to the header file.
* '''Class definitions''': Put public methods at the top of the definition. They're usually the most interesting part from a user's point of view. Private stuff at the bottom.
    class Foo 
    {
      public:
      Foo();
      ~Foo();
    
      /**
       * The foo() method. Does some fooish stuff, yo!
       * @param bar Bar instance to be used in foo().
       * @return An instance of Baz that does something fantastic!
       */
      Baz* foo(Bar* bar);
      
      private:
      /* private instance vars etc go here.*/
    };
** '''Instance variables''' should usually be accessible through getter and setter methods and thus be private. In some cases having them public is fine (e.g. when they're accessed all over the place and modifiying them happens all over the place as well. Usually this is the case for "dumb classes" used as pure data structures. We should consider using a '''struct''' instead for these cases.). Also, don't use prefixes for public instance variables, since it's ugly to use. For private instance variables we could choose to use '''m_foo''' and have a getter method be just '''foo()''' and a setter '''setFoo()'''. 
* '''Namespaces''': We probably should use them.
* '''Codeblocks''': (Use braces always for clarity and to prevent bugs while editing code)
    if(true) {
      foo = bar;
    }

    if(true)
    {
      foo = bar;
      foo2 = bar2;
    }
* '''Spacing''':
    Foo* bar = new Foo();
    fooBar(param1, param2, param3);
    for(int i = 0; i &lt; 1; i++)
    {
     
    }</text>
    <sha1>3ffa14e81db6a40481a2b6be213853989e6e1481</sha1>
  </revision>
  <revision>
    <id>65</id>
    <parentid>64</parentid>
    <timestamp>2010-12-07T10:02:21Z</timestamp>
    <contributor>
      <username>Bakkdoor</username>
      <id>11</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2565" xml:space="preserve">This is a suggestion for a coding style to be used consistently accross Mineserver's source code.

* '''Indentation''': 2 spaces
* '''Class names''': Camelcase, starting with uppercase letter, e.g.: '''FurnaceManager'''
* '''Variable and method names''': Camelcase, starting with lowercase letter, e.g.: '''updateWorld()''', '''userCommands'''.
** '''Pointer variables''': Use '''Foo* bar''' instead of '''Foo *bar'''
** Using short names for loop variables is ok, e.g. '''i''', '''j'''. Otherwise use descriptive names and don't use abbreviations all over the place, to make the code more readable.
* '''Inline methods''': Keep them short (max 10-15 lines at most).
* '''Documentation''': Use javadoc-style documentation for at least all public methods. Example:
    /**
     * The foo() method. Does some fooish stuff, yo!
     * @param bar Bar instance to be used in foo().
     * @return An instance of Baz that does something fantastic!
     */
     Baz* Foo::foo(Bar* bar);
** Note: Documentation should go in to the header file.
* '''Class definitions''': Put public methods at the top of the definition. They're usually the most interesting part from a user's point of view. Private stuff at the bottom.
    class Foo 
    {
      public:
      Foo();
      ~Foo();
    
      /**
       * The foo() method. Does some fooish stuff, yo!
       * @param bar Bar instance to be used in foo().
       * @return An instance of Baz that does something fantastic!
       */
      Baz* foo(Bar* bar);
      
      private:
      /* private instance vars etc go here.*/
    };
** '''Instance variables''' should usually be accessible through getter and setter methods and thus be private. In some cases having them public is fine (e.g. when they're accessed all over the place and modifiying them happens all over the place as well. Usually this is the case for "dumb classes" used as pure data structures. We should consider using a '''struct''' instead for these cases.). Also, don't use prefixes for public instance variables, since it's ugly to use. For private instance variables we could choose to use '''m_foo''' and have a getter method be just '''foo()''' and a setter '''setFoo()'''. 
* '''Namespaces''': We probably should use them.
* '''Codeblocks''': (Use braces always for clarity and to prevent bugs while editing code)
    if(true)
    {
      foo = bar;
    }

    if(true)
    {
      foo = bar;
      foo2 = bar2;
    }
* '''Spacing''':
    Foo* bar = new Foo();
    fooBar(param1, param2, param3);
    for(int i = 0; i &lt; 1; i++)
    {
     
    }</text>
    <sha1>95cfa0f0f1cd1496af32286688471a920892a621</sha1>
  </revision>
  <revision>
    <id>66</id>
    <parentid>65</parentid>
    <timestamp>2010-12-07T10:04:47Z</timestamp>
    <contributor>
      <username>Bakkdoor</username>
      <id>11</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2582" xml:space="preserve">This is a suggestion for a coding style to be used consistently accross Mineserver's source code.

* '''Indentation''': 2 spaces
* '''Class names''': Camelcase, starting with uppercase letter, e.g.: '''FurnaceManager'''
* '''Variable and method names''': Camelcase, starting with lowercase letter, e.g.: '''updateWorld()''', '''userCommands'''.
** '''Pointer variables''': Use '''Foo* bar''' instead of '''Foo *bar'''
** Using short names for loop variables is ok, e.g. '''i''', '''j'''. Otherwise use descriptive names and don't use abbreviations all over the place, to make the code more readable.
* '''Inline methods''': Keep them short (max 10-15 lines at most).
* '''Documentation''': Use doxygen-style (javadoc-style?) documentation for at least all public methods. Example:
    /**
     * The foo() method. Does some fooish stuff, yo!
     * @param bar Bar instance to be used in foo().
     * @return An instance of Baz that does something fantastic!
     */
     Baz* Foo::foo(Bar* bar);
** Note: Documentation should go in to the header file.
* '''Class definitions''': Put public methods at the top of the definition. They're usually the most interesting part from a user's point of view. Private stuff at the bottom.
    class Foo 
    {
      public:
      Foo();
      ~Foo();
    
      /**
       * The foo() method. Does some fooish stuff, yo!
       * @param bar Bar instance to be used in foo().
       * @return An instance of Baz that does something fantastic!
       */
      Baz* foo(Bar* bar);
      
      private:
      /* private instance vars etc go here.*/
    };
** '''Instance variables''' should usually be accessible through getter and setter methods and thus be private. In some cases having them public is fine (e.g. when they're accessed all over the place and modifiying them happens all over the place as well. Usually this is the case for "dumb classes" used as pure data structures. We should consider using a '''struct''' instead for these cases.). Also, don't use prefixes for public instance variables, since it's ugly to use. For private instance variables we could choose to use '''m_foo''' and have a getter method be just '''foo()''' and a setter '''setFoo()'''. 
* '''Namespaces''': We probably should use them.
* '''Codeblocks''': (Use braces always for clarity and to prevent bugs while editing code)
    if(true)
    {
      foo = bar;
    }

    if(true)
    {
      foo = bar;
      foo2 = bar2;
    }
* '''Spacing''':
    Foo* bar = new Foo();
    fooBar(param1, param2, param3);
    for(int i = 0; i &lt; 1; i++)
    {
     
    }</text>
    <sha1>62dc3a4c87a96f37e5d23661709eb3460c75dbaf</sha1>
  </revision>
  <revision>
    <id>67</id>
    <parentid>66</parentid>
    <timestamp>2010-12-07T14:38:22Z</timestamp>
    <contributor>
      <username>Bakkdoor</username>
      <id>11</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2693" xml:space="preserve">This is a suggestion for a coding style to be used consistently accross Mineserver's source code.

* '''Indentation''': 2 spaces
* '''Class names''': Camelcase, starting with uppercase letter, e.g.: '''FurnaceManager'''
* '''Variable and method names''': Camelcase, starting with lowercase letter, e.g.: '''updateWorld()''', '''userCommands'''.
** '''Pointer variables''': Use '''Foo* bar''' instead of '''Foo *bar'''
** Using short names for loop variables is ok, e.g. '''i''', '''j'''. Otherwise use descriptive names and don't use abbreviations all over the place, to make the code more readable.
* '''Inline methods''': Keep them short (max 10-15 lines at most).
* '''Documentation''': Use doxygen-style (javadoc-style?) documentation for at least all public methods. Example:
    /**
     * The foo() method. Does some fooish stuff, yo!
     * @param bar Bar instance to be used in foo().
     * @return An instance of Baz that does something fantastic!
     */
     Baz* Foo::foo(Bar* bar);
** Note: Documentation should go in to the header file.
* '''Class definitions''': Put public methods at the top of the definition. They're usually the most interesting part from a user's point of view. Private stuff at the bottom.
    class Foo 
    {
      public:
      Foo();
      ~Foo();
    
      /**
       * The foo() method. Does some fooish stuff, yo!
       * @param bar Bar instance to be used in foo().
       * @return An instance of Baz that does something fantastic!
       */
      Baz* foo(Bar* bar);
      
      private:
      /* private instance vars etc go here.*/
    };
** '''Instance variables''' should usually be accessible through getter and setter methods and thus be private. In some cases having them public is fine (e.g. when they're accessed all over the place and modifiying them happens all over the place as well. Usually this is the case for "dumb classes" used as pure data structures. We should consider using a '''struct''' instead for these cases.). Also, don't use prefixes for public instance variables, since it's ugly to use. For private instance variables we could choose to use '''m_foo''' and have a getter method be just '''foo()''' and a setter '''setFoo()'''.
** '''Static (class) variables''' should start with just an underscore, e.g. '''_instance''', '''_users''' etc.
* '''Namespaces''': We probably should use them.
* '''Codeblocks''': (Use braces always for clarity and to prevent bugs while editing code)
    if(true)
    {
      foo = bar;
    }

    if(true)
    {
      foo = bar;
      foo2 = bar2;
    }
* '''Spacing''':
    Foo* bar = new Foo();
    fooBar(param1, param2, param3);
    for(int i = 0; i &lt; 1; i++)
    {
     
    }</text>
    <sha1>a349106e07419e184337d693d6cd14b31cfc68d5</sha1>
  </revision>
</page>
<page arvcontinue="20101206223208|51">
  <title>Configuration</title>
  <ns>0</ns>
  <id>2</id>
  <revision>
    <id>61</id>
    <parentid>16</parentid>
    <timestamp>2010-12-07T02:39:02Z</timestamp>
    <contributor>
      <username>Bakkdoor</username>
      <id>11</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2812" xml:space="preserve">Mineserver uses a collection of text files for configuration. They can be edited in any regular text editor and follow the format of &lt;code&gt;key = value&lt;/code&gt;.

List of files:

==config.cfg==

This is the main configuration file where you will set the core options for the server. A default config file is provided with each distribution of Mineserver.

====Available Options====

{| class="wikitable"
|-
! Name
! Description
! Optional
! Default
|-
| ip
| Specifies the IP to bind to.
| Y
| 0.0.0.0
|-
| port
| The port that the server will listen on.
| Y
| 25565
|-
| servername
| The name of the server as displayed to the client and on the server list.
| N
|
|-
| userlimit
| The number of users allowed to be connected at any one time.
| Y
| 50
|-
| map_release_time
| The amount of time (in seconds) that a chunk will be kept in memory for without being accessed or modified.
| Y
| 10
|-
| use_whitelist
| Defines the usage of a whitelist.
| Y
| false
|-
| mapdir
| The directory where the map data will be held.
| N
| testmap
|-
| wrong_protocol_message
| The text displayed to clients if their version of Minecraft is incorrect.
| N
| Wrong protocol version
|-
| server_full_message
| The text displayed to clients if the server is full when they try to join.
| N
| Server is currently full
|-
| default_kick_message
| The message sent to a client when they are kicked _if_ no message is specified.
| N
| This is a default kick message
|-
| default_banned_message
| The message sent to a client when they try to log on, and are banned.
| N
| You have been banned from this server
|-
| default_whitelist_message
| If a player is not on the whitelist, this gets sent to them.
| N
| You are not on the whitelist
|-
| kit_&lt;name&gt;
| A comma separated list of items to give to players when they use the /kit &lt;name&gt; command. Any number of kits can be defined.
| Y
| kit_starter = "273, 274, 275, 50, 50, 50, 50, 50"
|-
| liquid_physics
| Whether or not to simulate water/lava physics.
| Y
| true
|-
| map_flatland
| Whether or not to generate flatland maps.
| Y
| false
|}

==item_alias.cfg==

This is a set of item name/id pairs for use with the /give command and other parts of the application. Multiple item names can be defined for a single ID by simply using it twice.

==roles.txt==

This is a list of players and their permissions/roles. You can define admins, operators (ops) and members (trusted people). Everyone not listed here will have the Guest permissions by default.

==banned.txt==

This is a list of banned players, one per line.

==motd.txt==

This file holds the message of the day, displayed to users as they connect or use /motd.

==rules.txt==

This file holds the rules, displayed to users when they use /rules.

==whitelist.txt==

This is a list of players on the whitelist, one per line.</text>
    <sha1>32073b092085ddd4e842117001e560279550116b</sha1>
  </revision>
  <revision>
    <id>62</id>
    <parentid>61</parentid>
    <timestamp>2010-12-07T02:40:14Z</timestamp>
    <contributor>
      <username>Bakkdoor</username>
      <id>11</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2972" xml:space="preserve">Mineserver uses a collection of text files for configuration. They can be edited in any regular text editor and follow the format of &lt;code&gt;key = value&lt;/code&gt;.

List of files:

==config.cfg==

This is the main configuration file where you will set the core options for the server. A default config file is provided with each distribution of Mineserver.

====Available Options====

{| class="wikitable"
|-
! Name
! Description
! Optional
! Default
|-
| ip
| Specifies the IP to bind to.
| Y
| 0.0.0.0
|-
| port
| The port that the server will listen on.
| Y
| 25565
|-
| servername
| The name of the server as displayed to the client and on the server list.
| N
|
|-
| userlimit
| The number of users allowed to be connected at any one time.
| Y
| 50
|-
| map_release_time
| The amount of time (in seconds) that a chunk will be kept in memory for without being accessed or modified.
| Y
| 10
|-
| use_whitelist
| Defines the usage of a whitelist.
| Y
| false
|-
| mapdir
| The directory where the map data will be held.
| N
| testmap
|-
| wrong_protocol_message
| The text displayed to clients if their version of Minecraft is incorrect.
| N
| Wrong protocol version
|-
| server_full_message
| The text displayed to clients if the server is full when they try to join.
| N
| Server is currently full
|-
| default_kick_message
| The message sent to a client when they are kicked _if_ no message is specified.
| N
| This is a default kick message
|-
| default_banned_message
| The message sent to a client when they try to log on, and are banned.
| N
| You have been banned from this server
|-
| default_whitelist_message
| If a player is not on the whitelist, this gets sent to them.
| N
| You are not on the whitelist
|-
| kit_&lt;name&gt;
| A comma separated list of items to give to players when they use the /kit &lt;name&gt; command. Any number of kits can be defined.
| Y
| kit_starter = "273, 274, 275, 50, 50, 50, 50, 50"
|-
| liquid_physics
| Whether or not to simulate water/lava physics.
| Y
| true
|-
| map_flatland
| Whether or not to generate flatland maps.
| Y
| false
|}

==item_alias.cfg==

This is a set of item name/id pairs for use with the /give command and other parts of the application. Multiple item names can be defined for a single ID by simply using it twice.

==roles.txt==

This is a list of players and their permissions/roles. You can define admins, operators (ops) and members (trusted people). Everyone not listed here will have the Guest permissions by default.

==banned.txt==

This is a list of banned players, one per line.

==motd.txt==

This file holds the message of the day, displayed to users as they connect or use /motd.

==rules.txt==

This file holds the rules, displayed to users when they use /rules.

==whitelist.txt==

This is a list of players on the whitelist, one per line.

==commands.cfg==

This is a list of available chat commands, each associated with a minimum permission role needed to execute it (admin, op, member or guest).</text>
    <sha1>79d8f3560f41e85f6f8513e2083c45f7c60f49fc</sha1>
  </revision>
</page>
<page arvcontinue="20101206223208|51">
  <title>Installation</title>
  <ns>0</ns>
  <id>3</id>
  <revision>
    <id>68</id>
    <parentid>36</parentid>
    <timestamp>2010-12-14T09:56:54Z</timestamp>
    <contributor>
      <username>Krono</username>
      <id>12</id>
    </contributor>
    <comment>/* OS X */ Homebrew alternative</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="8093" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

Most dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

However CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  sudo cp -R include /usr/local/include/noise
  sudo cp lib/* /usr/local/lib
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====

To install third party libraries on OS X, some convenient ways exist.
Note that zlib ships with OS X by default.

===== MacPorts or Fink =====

You can install zlib and libevent using Macports:

 sudo port install libevent

or Fink:

 sudo apt-get install libevent1

Either way, you will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

or Fink:

 sudo apt-get install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===== Homebrew =====

With homebrew installed, you can just install libevent:

 brew install libevent

A formular for libnoise can be found on [http://github.com/krono/homebrew krono’s homebrew fork].
Using that, you can install libnoise just the same way:

 brew install libnoise

It does not depend on cmake and doxygen.

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that below.

'''NOTE'''! If you are using debian/ubuntu or similar use &lt;code&gt;make DEBIAN=1&lt;/code&gt; instead of &lt;code&gt;make&lt;/code&gt;

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

You can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

  cd src
  CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>705eae9dde784a8e97df668f9670462cd8a4b3b4</sha1>
  </revision>
  <revision>
    <id>69</id>
    <parentid>68</parentid>
    <timestamp>2010-12-14T10:05:00Z</timestamp>
    <contributor>
      <username>Krono</username>
      <id>12</id>
    </contributor>
    <comment>/* OS X */ Alternative build instructions</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="8401" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

Most dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

However CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  sudo cp -R include /usr/local/include/noise
  sudo cp lib/* /usr/local/lib
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====

To install third party libraries on OS X, some convenient ways exist.
Note that zlib ships with OS X by default.

===== MacPorts or Fink =====

You can install zlib and libevent using Macports:

 sudo port install libevent

or Fink:

 sudo apt-get install libevent1

Either way, you will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

or Fink:

 sudo apt-get install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===== Homebrew =====

With homebrew installed, you can just install libevent:

 brew install libevent

A formular for libnoise can be found on [http://github.com/krono/homebrew krono’s homebrew fork].
Using that, you can install libnoise just the same way:

 brew install libnoise

It does not depend on cmake and doxygen.

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that below.

'''NOTE'''! If you are using debian/ubuntu or similar use &lt;code&gt;make DEBIAN=1&lt;/code&gt; instead of &lt;code&gt;make&lt;/code&gt;

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

===== Macports =====

You can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

  cd src
  CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===== Fink =====

You can build, ensuring that you point the compiler to any Fink-installed headers and libraries:

  cd src
  CXXFLAGS=-I/sw/include LDFLAGS=-L/sw/lib make


===== Homebrew =====

Homebrew installs in a System-Known location, so you just have to make.
  cd src
  make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>468a9e836fc38827f9bff5ef86e3b4059f9de692</sha1>
  </revision>
  <revision>
    <id>70</id>
    <parentid>69</parentid>
    <timestamp>2010-12-21T09:48:30Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <minor/>
    <comment>/* Prerequisites */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="8432" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 4 external libraries: ncurses (pdcurses on windows), zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

Most dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

However CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  sudo cp -R include /usr/local/include/noise
  sudo cp lib/* /usr/local/lib
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====

To install third party libraries on OS X, some convenient ways exist.
Note that zlib ships with OS X by default.

===== MacPorts or Fink =====

You can install zlib and libevent using Macports:

 sudo port install libevent

or Fink:

 sudo apt-get install libevent1

Either way, you will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

or Fink:

 sudo apt-get install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===== Homebrew =====

With homebrew installed, you can just install libevent:

 brew install libevent

A formular for libnoise can be found on [http://github.com/krono/homebrew krono’s homebrew fork].
Using that, you can install libnoise just the same way:

 brew install libnoise

It does not depend on cmake and doxygen.

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that below.

'''NOTE'''! If you are using debian/ubuntu or similar use &lt;code&gt;make DEBIAN=1&lt;/code&gt; instead of &lt;code&gt;make&lt;/code&gt;

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

===== Macports =====

You can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

  cd src
  CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===== Fink =====

You can build, ensuring that you point the compiler to any Fink-installed headers and libraries:

  cd src
  CXXFLAGS=-I/sw/include LDFLAGS=-L/sw/lib make


===== Homebrew =====

Homebrew installs in a System-Known location, so you just have to make.
  cd src
  make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>bd87207a04aee37bfcbb64859a32422070ee8313</sha1>
  </revision>
  <revision>
    <id>93</id>
    <parentid>70</parentid>
    <timestamp>2011-01-12T20:58:39Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <minor/>
    <comment>/* Prerequisites */ libnoise url</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="8522" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 4 external libraries: ncurses (pdcurses on windows), zlib, libevent and libnoise (possibly from [https://github.com/qknight/libnoise https://github.com/qknight/libnoise]). The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

(needs to be filled in)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

Most dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

However CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  sudo cp -R include /usr/local/include/noise
  sudo cp lib/* /usr/local/lib
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====

To install third party libraries on OS X, some convenient ways exist.
Note that zlib ships with OS X by default.

===== MacPorts or Fink =====

You can install zlib and libevent using Macports:

 sudo port install libevent

or Fink:

 sudo apt-get install libevent1

Either way, you will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

or Fink:

 sudo apt-get install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===== Homebrew =====

With homebrew installed, you can just install libevent:

 brew install libevent

A formular for libnoise can be found on [http://github.com/krono/homebrew krono’s homebrew fork].
Using that, you can install libnoise just the same way:

 brew install libnoise

It does not depend on cmake and doxygen.

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that below.

'''NOTE'''! If you are using debian/ubuntu or similar use &lt;code&gt;make DEBIAN=1&lt;/code&gt; instead of &lt;code&gt;make&lt;/code&gt;

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

===== Macports =====

You can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

  cd src
  CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===== Fink =====

You can build, ensuring that you point the compiler to any Fink-installed headers and libraries:

  cd src
  CXXFLAGS=-I/sw/include LDFLAGS=-L/sw/lib make


===== Homebrew =====

Homebrew installs in a System-Known location, so you just have to make.
  cd src
  make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>dd7de0ea2e96957f5de7aac3178f098235ea73db</sha1>
  </revision>
  <revision>
    <id>96</id>
    <parentid>93</parentid>
    <timestamp>2011-01-13T22:13:37Z</timestamp>
    <contributor>
      <username>Liamallan</username>
      <id>14</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="8901" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 4 external libraries: ncurses (pdcurses on windows), zlib, libevent and libnoise (possibly from [https://github.com/qknight/libnoise https://github.com/qknight/libnoise]). The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

Download the latest zip file from mineserver.be/downloads and make a new folder on your desktop, and name it whatever you want
Extract the files from the zip into that folder and edit the configuration, make sure your name is on the roles.txt list for you to be admin
Goto ahead and run the mineserver bat file and the server will start

To get your ip address, goto www.cmyip.com

Edited by liamallan 

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

Most dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

However CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  sudo cp -R include /usr/local/include/noise
  sudo cp lib/* /usr/local/lib
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====

To install third party libraries on OS X, some convenient ways exist.
Note that zlib ships with OS X by default.

===== MacPorts or Fink =====

You can install zlib and libevent using Macports:

 sudo port install libevent

or Fink:

 sudo apt-get install libevent1

Either way, you will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

or Fink:

 sudo apt-get install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===== Homebrew =====

With homebrew installed, you can just install libevent:

 brew install libevent

A formular for libnoise can be found on [http://github.com/krono/homebrew krono’s homebrew fork].
Using that, you can install libnoise just the same way:

 brew install libnoise

It does not depend on cmake and doxygen.

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that below.

'''NOTE'''! If you are using debian/ubuntu or similar use &lt;code&gt;make DEBIAN=1&lt;/code&gt; instead of &lt;code&gt;make&lt;/code&gt;

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

===== Macports =====

You can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

  cd src
  CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===== Fink =====

You can build, ensuring that you point the compiler to any Fink-installed headers and libraries:

  cd src
  CXXFLAGS=-I/sw/include LDFLAGS=-L/sw/lib make


===== Homebrew =====

Homebrew installs in a System-Known location, so you just have to make.
  cd src
  make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>23a24d15fcb8483e5987d3a6d59f8a791756ca40</sha1>
  </revision>
</page>
<page arvcontinue="20101206223208|51">
  <title>User talk:Nathacof</title>
  <ns>3</ns>
  <id>7</id>
  <revision>
    <id>71</id>
    <timestamp>2010-12-27T22:28:14Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>Created page with "= Plugins = == Binlog == ===Configuration === ;(bool) enable_binlog :enable binary logging ;(string) binlog :filename of the binary log ===Commands=== Revert changes from the bin..."</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="313" xml:space="preserve">= Plugins =
== Binlog ==
===Configuration ===
;(bool) enable_binlog
:enable binary logging
;(string) binlog
:filename of the binary log
===Commands===
Revert changes from the binary log:
&lt;code&gt;/rollback &lt;timestamp&gt; &lt;nick&gt;&lt;/code&gt;
Playback events found in the binary log:
&lt;code&gt; /playback &lt;timestamp&gt; &lt;nick&gt; &lt;/code&gt;</text>
    <sha1>4c6c42583a299f068ad3a1c64522c2fdcfb1a1fd</sha1>
  </revision>
  <revision>
    <id>72</id>
    <parentid>71</parentid>
    <timestamp>2010-12-27T22:28:44Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>/* Commands */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="317" xml:space="preserve">= Plugins =
== Binlog ==
===Configuration ===
;(bool) enable_binlog
:enable binary logging
;(string) binlog
:filename of the binary log
===Commands===
;Revert changes from the binary log:
:&lt;code&gt;/rollback &lt;timestamp&gt; &lt;nick&gt;&lt;/code&gt;
;Playback events found in the binary log:
:&lt;code&gt; /playback &lt;timestamp&gt; &lt;nick&gt; &lt;/code&gt;</text>
    <sha1>4e0969593f305d93eee67701ed5aa2c5e34fc7c3</sha1>
  </revision>
</page>
<page arvcontinue="20101206223208|51">
  <title>Plugin API</title>
  <ns>0</ns>
  <id>8</id>
  <revision>
    <id>73</id>
    <timestamp>2010-12-29T19:15:42Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <comment>Created page with "Mineserver uses a C-plugin API which is described in this page.  ==Creating a plugin==  You will need to include &lt;code&gt;plugin_api.h&lt;/code&gt; to your project.  ...write some more st..."</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2342" xml:space="preserve">Mineserver uses a C-plugin API which is described in this page.

==Creating a plugin==

You will need to include &lt;code&gt;plugin_api.h&lt;/code&gt; to your project.

...write some more stuff here...

Example plugin structure:

&lt;code&gt;
  #include "plugin_api.h"
  #define PLUGIN_VERSION 1.0
  mineserver_pointer_struct* mineserver;
  PLUGIN_API_EXPORT void (plugin_name)_init(mineserver_pointer_struct* mineserver_temp)
  {
    mineserver = mineserver_temp;
    if (mineserver-&gt;plugin.getPluginVersion("(plugin_name)") &gt; 0)
    {
      mineserver-&gt;screen.log("(plugin_name) is already loaded v." +dtos(mineserver-&gt;plugin.getPluginVersion("(plugin_name)")));
      return;
    }
    mineserver-&gt;screen.log("Loaded \"(plugin_name)\"!");
    mineserver-&gt;plugin.setPluginVersion("(plugin_name)", PLUGIN_VERSION);
    mineserver-&gt;callback.add_hook("ChatPre", (void *)chatPreFunction);
  }
  PLUGIN_API_EXPORT void (plugin_name)_shutdown(void)
  {
    if (mineserver-&gt;plugin.getPluginVersion("(plugin_name)") &lt;= 0)
    {
      mineserver-&gt;screen.log("(plugin_name) is not loaded!");
      return;
    }
  }
&lt;/code&gt;

==Available functions==


===Mineserver===

====Chat====

{| class="wikitable"
|-
! Function
! Parameters
! Return value
|-
| '''sendmsgTo'''
| (std::string user,std::string msg)
| bool, telling it the user was found
|-
| colspan="3" | This function is used to send msg to single user
|-
| '''sendmsg'''
| (std::string message)
| bool, telling it the user was found
|-
| colspan="3" | This function is used to send msg to single user
|}

====Screen====

{| class="wikitable"
|-
! Function
! Parameters
! Return value
|-
| '''log'''
| (std::string message)
| none
|-
| colspan="3" | Prints message to server window
|}


====Map====

{| class="wikitable"
|-
! Function
! Parameters
! Return value
|-
| '''createPickupSpawn'''
| (int x, int y, int z, int type, int count, int health, std::string user)
| none
|-
| colspan="3" | Spawns an item at (x,y,z) with type,count and health specified. If "user" is set, he will not be able to pick up the item right away to make it possible to throw stuff away.
|-
| '''setTime'''
| (std::string timeValue)
| bool
|-
| colspan="3" | Sets server time to timeValue, which can be a string of value 0-24000
|-
| '''getSpawn'''
| (int* x, int* y, int* z)
| void
|-
| colspan="3" | Gets server spawn position
|}</text>
    <sha1>bc40b44e2d1bd16d6f9792c0f5b05c08d0f550f9</sha1>
  </revision>
  <revision>
    <id>76</id>
    <parentid>73</parentid>
    <timestamp>2011-01-03T23:09:03Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <comment>Callbacks</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2973" xml:space="preserve">Mineserver uses a C-plugin API which is described in this page.

==Creating a plugin==

You will need to include &lt;code&gt;plugin_api.h&lt;/code&gt; to your project.

...write some more stuff here...

Example plugin structure:

&lt;code&gt;
  #include "plugin_api.h"
  #define PLUGIN_VERSION 1.0
  mineserver_pointer_struct* mineserver;
  PLUGIN_API_EXPORT void (plugin_name)_init(mineserver_pointer_struct* mineserver_temp)
  {
    mineserver = mineserver_temp;
    if (mineserver-&gt;plugin.getPluginVersion("(plugin_name)") &gt; 0)
    {
      mineserver-&gt;screen.log("(plugin_name) is already loaded v." +dtos(mineserver-&gt;plugin.getPluginVersion("(plugin_name)")));
      return;
    }
    mineserver-&gt;screen.log("Loaded \"(plugin_name)\"!");
    mineserver-&gt;plugin.setPluginVersion("(plugin_name)", PLUGIN_VERSION);
    mineserver-&gt;callback.add_hook("ChatPre", (void *)chatPreFunction);
  }
  PLUGIN_API_EXPORT void (plugin_name)_shutdown(void)
  {
    if (mineserver-&gt;plugin.getPluginVersion("(plugin_name)") &lt;= 0)
    {
      mineserver-&gt;screen.log("(plugin_name) is not loaded!");
      return;
    }
  }
&lt;/code&gt;

==Available functions==


===Mineserver===

====Chat====

{| class="wikitable"
|-
! Function
! Parameters
! Return value
|-
| '''sendmsgTo'''
| (std::string user,std::string msg)
| bool, telling it the user was found
|-
| colspan="3" | This function is used to send msg to single user
|-
| '''sendmsg'''
| (std::string message)
| bool, telling it the user was found
|-
| colspan="3" | This function is used to send msg to single user
|}

====Screen====

{| class="wikitable"
|-
! Function
! Parameters
! Return value
|-
| '''log'''
| (std::string message)
| none
|-
| colspan="3" | Prints message to server window
|}


====Map====

{| class="wikitable"
|-
! Function
! Parameters
! Return value
|-
| '''createPickupSpawn'''
| (int x, int y, int z, int type, int count, int health, std::string user)
| none
|-
| colspan="3" | Spawns an item at (x,y,z) with type,count and health specified. If "user" is set, he will not be able to pick up the item right away to make it possible to throw stuff away.
|-
| '''setTime'''
| (std::string timeValue)
| bool
|-
| colspan="3" | Sets server time to timeValue, which can be a string of value 0-24000
|-
| '''getSpawn'''
| (int* x, int* y, int* z)
| void
|-
| colspan="3" | Gets server spawn position
|}

==Available callbacks==


{| class="wikitable"
|-
! Name
! Parameters
! Return value
|-
| '''ChatPre&lt;'''
| const std::string&amp; nick, std::string msg
| bool
|-
| colspan="3" | called on chat message prosessing, returning false will terminate the callback.
|-
| '''BlockPlacePre'''
| const std::string&amp; nick, int x,char y,int z,char block
| bool
|-
| colspan="3" | called on block placement, returning false will prevent block placement and terminate callback.
|-
| '''BlockBreakPre'''
| (int* x, int* y, int* z)
| bool
|-
| colspan="3" | called on block break, returning false will prevent block breaking and terminate callback.
|}</text>
    <sha1>35752d8899dbcecc50a51ef4548782d5917e3de9</sha1>
  </revision>
  <revision>
    <id>77</id>
    <parentid>76</parentid>
    <timestamp>2011-01-04T00:06:54Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="3307" xml:space="preserve">Mineserver uses a C-plugin API which is described in this page.

==Creating a plugin==

You will need to include &lt;code&gt;plugin_api.h&lt;/code&gt; to your project.

...write some more stuff here...

Example plugin structure:

&lt;code&gt;
  #include "plugin_api.h"
  #define PLUGIN_VERSION 1.0
  mineserver_pointer_struct* mineserver;
  PLUGIN_API_EXPORT void (plugin_name)_init(mineserver_pointer_struct* mineserver_temp)
  {
    mineserver = mineserver_temp;
    if (mineserver-&gt;plugin.getPluginVersion("(plugin_name)") &gt; 0)
    {
      mineserver-&gt;screen.log("(plugin_name) is already loaded v." +dtos(mineserver-&gt;plugin.getPluginVersion("(plugin_name)")));
      return;
    }
    mineserver-&gt;screen.log("Loaded \"(plugin_name)\"!");
    mineserver-&gt;plugin.setPluginVersion("(plugin_name)", PLUGIN_VERSION);
    mineserver-&gt;callback.add_hook("ChatPre", (void *)chatPreFunction);
  }
  PLUGIN_API_EXPORT void (plugin_name)_shutdown(void)
  {
    if (mineserver-&gt;plugin.getPluginVersion("(plugin_name)") &lt;= 0)
    {
      mineserver-&gt;screen.log("(plugin_name) is not loaded!");
      return;
    }
  }
&lt;/code&gt;

==Available functions==


===Mineserver===

====Chat====

{| class="wikitable"
|-
! Function
! Parameters
! Return value
|-
| '''sendmsgTo'''
| (std::string user,std::string msg)
| bool, telling it the user was found
|-
| colspan="3" | This function is used to send msg to single user
|-
| '''sendmsg'''
| (std::string message)
| bool, telling it the user was found
|-
| colspan="3" | This function is used to send msg to single user
|}

====Screen====

{| class="wikitable"
|-
! Function
! Parameters
! Return value
|-
| '''log'''
| (std::string message)
| none
|-
| colspan="3" | Prints message to server window
|}


====Map====

{| class="wikitable"
|-
! Function
! Parameters
! Return value
|-
| '''createPickupSpawn'''
| (int x, int y, int z, int type, int count, int health, std::string user)
| none
|-
| colspan="3" | Spawns an item at (x,y,z) with type,count and health specified. If "user" is set, he will not be able to pick up the item right away to make it possible to throw stuff away.
|-
| '''setTime'''
| (std::string timeValue)
| bool
|-
| colspan="3" | Sets server time to timeValue, which can be a string of value 0-24000
|-
| '''getSpawn'''
| (int* x, int* y, int* z)
| void
|-
| colspan="3" | Gets server spawn position
|-
| '''getBlock'''
| (int x, int y, int z, unsigned char* type,unsigned char* meta)
| bool
|-
| colspan="3" | Get block type and metadata (absolute block coordinates)
|-
| '''setBlock'''
| (int x, int y, int z, unsigned char type,unsigned char meta)
| bool
|-
| colspan="3" | Set block type and metadata (absolute block coordinates)
|}

==Available callbacks==


{| class="wikitable"
|-
! Name
! Parameters
! Return value
|-
| '''ChatPre&lt;'''
| const std::string&amp; nick, std::string msg
| bool
|-
| colspan="3" | called on chat message prosessing, returning false will terminate the callback.
|-
| '''BlockPlacePre'''
| const std::string&amp; nick, int x,char y,int z,char block
| bool
|-
| colspan="3" | called on block placement, returning false will prevent block placement and terminate callback.
|-
| '''BlockBreakPre'''
| (int* x, int* y, int* z)
| bool
|-
| colspan="3" | called on block break, returning false will prevent block breaking and terminate callback.
|}</text>
    <sha1>ec1b53c4c993c464453af57a0744a51e2a460c4a</sha1>
  </revision>
  <revision>
    <id>78</id>
    <parentid>77</parentid>
    <timestamp>2011-01-04T00:29:46Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <minor/>
    <comment>/* Available callbacks */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="3306" xml:space="preserve">Mineserver uses a C-plugin API which is described in this page.

==Creating a plugin==

You will need to include &lt;code&gt;plugin_api.h&lt;/code&gt; to your project.

...write some more stuff here...

Example plugin structure:

&lt;code&gt;
  #include "plugin_api.h"
  #define PLUGIN_VERSION 1.0
  mineserver_pointer_struct* mineserver;
  PLUGIN_API_EXPORT void (plugin_name)_init(mineserver_pointer_struct* mineserver_temp)
  {
    mineserver = mineserver_temp;
    if (mineserver-&gt;plugin.getPluginVersion("(plugin_name)") &gt; 0)
    {
      mineserver-&gt;screen.log("(plugin_name) is already loaded v." +dtos(mineserver-&gt;plugin.getPluginVersion("(plugin_name)")));
      return;
    }
    mineserver-&gt;screen.log("Loaded \"(plugin_name)\"!");
    mineserver-&gt;plugin.setPluginVersion("(plugin_name)", PLUGIN_VERSION);
    mineserver-&gt;callback.add_hook("ChatPre", (void *)chatPreFunction);
  }
  PLUGIN_API_EXPORT void (plugin_name)_shutdown(void)
  {
    if (mineserver-&gt;plugin.getPluginVersion("(plugin_name)") &lt;= 0)
    {
      mineserver-&gt;screen.log("(plugin_name) is not loaded!");
      return;
    }
  }
&lt;/code&gt;

==Available functions==


===Mineserver===

====Chat====

{| class="wikitable"
|-
! Function
! Parameters
! Return value
|-
| '''sendmsgTo'''
| (std::string user,std::string msg)
| bool, telling it the user was found
|-
| colspan="3" | This function is used to send msg to single user
|-
| '''sendmsg'''
| (std::string message)
| bool, telling it the user was found
|-
| colspan="3" | This function is used to send msg to single user
|}

====Screen====

{| class="wikitable"
|-
! Function
! Parameters
! Return value
|-
| '''log'''
| (std::string message)
| none
|-
| colspan="3" | Prints message to server window
|}


====Map====

{| class="wikitable"
|-
! Function
! Parameters
! Return value
|-
| '''createPickupSpawn'''
| (int x, int y, int z, int type, int count, int health, std::string user)
| none
|-
| colspan="3" | Spawns an item at (x,y,z) with type,count and health specified. If "user" is set, he will not be able to pick up the item right away to make it possible to throw stuff away.
|-
| '''setTime'''
| (std::string timeValue)
| bool
|-
| colspan="3" | Sets server time to timeValue, which can be a string of value 0-24000
|-
| '''getSpawn'''
| (int* x, int* y, int* z)
| void
|-
| colspan="3" | Gets server spawn position
|-
| '''getBlock'''
| (int x, int y, int z, unsigned char* type,unsigned char* meta)
| bool
|-
| colspan="3" | Get block type and metadata (absolute block coordinates)
|-
| '''setBlock'''
| (int x, int y, int z, unsigned char type,unsigned char meta)
| bool
|-
| colspan="3" | Set block type and metadata (absolute block coordinates)
|}

==Available callbacks==


{| class="wikitable"
|-
! Name
! Parameters
! Return value
|-
| '''ChatPre'''
| const std::string&amp; nick, std::string msg
| bool
|-
| colspan="3" | called on chat message prosessing, returning false will terminate the callback.
|-
| '''BlockPlacePre'''
| const std::string&amp; nick, int x,char y,int z,char block
| bool
|-
| colspan="3" | called on block placement, returning false will prevent block placement and terminate callback.
|-
| '''BlockBreakPre'''
| (int* x, int* y, int* z)
| bool
|-
| colspan="3" | called on block break, returning false will prevent block breaking and terminate callback.
|}</text>
    <sha1>e22601de4f5c51520e3051c89109a04b345f7fd8</sha1>
  </revision>
  <revision>
    <id>83</id>
    <parentid>78</parentid>
    <timestamp>2011-01-06T23:05:15Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="3857" xml:space="preserve">Mineserver uses a C-plugin API which is described in this page.

==Creating a plugin==

You will need to include &lt;code&gt;plugin_api.h&lt;/code&gt; to your project.

...write some more stuff here...

Example plugin structure:

&lt;code&gt;
  #include "plugin_api.h"
  #define PLUGIN_VERSION 1.0
  std::string dtos( double n )
  {
    std::ostringstream result;
    result &lt;&lt; n;
    return result.str();
  }
  mineserver_pointer_struct* mineserver;
  std::string pluginName = "command";
  PLUGIN_API_EXPORT void (plugin_name)_init(mineserver_pointer_struct* mineserver_temp)
  {
    mineserver = mineserver_temp;
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str(),pluginName.size()) &gt; 0)
    {
      std::string msg="command is already loaded v." +dtos(mineserver-&gt;plugin.getPluginVersion(pluginName.c_str(),pluginName.size()));
      mineserver-&gt;screen.log(msg.c_str(),msg.size());
      return;
    }
    std::string msg="Loaded "+pluginName+"!";
    mineserver-&gt;screen.log(msg.c_str(),msg.size());
    mineserver-&gt;plugin.setPluginVersion(pluginName.c_str(),pluginName.size(), PLUGIN_COMMAND_VERSION);
    std::string hookName="ChatPre";
    mineserver-&gt;callback.add_hook(hookName.c_str(),hookName.size(), (void *)SOMEFUNCTIONNAME);
    hookName = "BlockPlacePre";
    mineserver-&gt;callback.add_hook(hookName.c_str(),hookName.size(), (void *)SOMEFUNCTIONNAME2);
  }
  PLUGIN_API_EXPORT void (plugin_name)_shutdown(void)
  {
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str(),pluginName.size()) &lt;= 0)
    {
      std::string msg="command is not loaded!";
      mineserver-&gt;screen.log(msg.c_str(),msg.size());
      return;
    }
  }
&lt;/code&gt;

==Available functions==


===Mineserver===

====Chat====

{| class="wikitable"
|-
! Function
! Parameters
! Return value
|-
| '''sendmsgTo'''
| (std::string user,std::string msg)
| bool, telling it the user was found
|-
| colspan="3" | This function is used to send msg to single user
|-
| '''sendmsg'''
| (std::string message)
| bool, telling it the user was found
|-
| colspan="3" | This function is used to send msg to single user
|}

====Screen====

{| class="wikitable"
|-
! Function
! Parameters
! Return value
|-
| '''log'''
| (std::string message)
| none
|-
| colspan="3" | Prints message to server window
|}


====Map====

{| class="wikitable"
|-
! Function
! Parameters
! Return value
|-
| '''createPickupSpawn'''
| (int x, int y, int z, int type, int count, int health, std::string user)
| none
|-
| colspan="3" | Spawns an item at (x,y,z) with type,count and health specified. If "user" is set, he will not be able to pick up the item right away to make it possible to throw stuff away.
|-
| '''setTime'''
| (std::string timeValue)
| bool
|-
| colspan="3" | Sets server time to timeValue, which can be a string of value 0-24000
|-
| '''getSpawn'''
| (int* x, int* y, int* z)
| void
|-
| colspan="3" | Gets server spawn position
|-
| '''getBlock'''
| (int x, int y, int z, unsigned char* type,unsigned char* meta)
| bool
|-
| colspan="3" | Get block type and metadata (absolute block coordinates)
|-
| '''setBlock'''
| (int x, int y, int z, unsigned char type,unsigned char meta)
| bool
|-
| colspan="3" | Set block type and metadata (absolute block coordinates)
|}

==Available callbacks==


{| class="wikitable"
|-
! Name
! Parameters
! Return value
|-
| '''ChatPre'''
| const std::string&amp; nick, std::string msg
| bool
|-
| colspan="3" | called on chat message prosessing, returning false will terminate the callback.
|-
| '''BlockPlacePre'''
| const std::string&amp; nick, int x,char y,int z,char block
| bool
|-
| colspan="3" | called on block placement, returning false will prevent block placement and terminate callback.
|-
| '''BlockBreakPre'''
| (int* x, int* y, int* z)
| bool
|-
| colspan="3" | called on block break, returning false will prevent block breaking and terminate callback.
|}</text>
    <sha1>41565060a2ff6ebff0dbd19a6232d111f5f82ca0</sha1>
  </revision>
  <revision>
    <id>84</id>
    <parentid>83</parentid>
    <timestamp>2011-01-06T23:32:09Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <comment>/* Chat */ new table formatting</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="4760" xml:space="preserve">Mineserver uses a C-plugin API which is described in this page.

==Creating a plugin==

You will need to include &lt;code&gt;plugin_api.h&lt;/code&gt; to your project.

...write some more stuff here...

Example plugin structure:

&lt;code&gt;
  #include "plugin_api.h"
  #define PLUGIN_VERSION 1.0
  std::string dtos( double n )
  {
    std::ostringstream result;
    result &lt;&lt; n;
    return result.str();
  }
  mineserver_pointer_struct* mineserver;
  std::string pluginName = "command";
  PLUGIN_API_EXPORT void (plugin_name)_init(mineserver_pointer_struct* mineserver_temp)
  {
    mineserver = mineserver_temp;
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str(),pluginName.size()) &gt; 0)
    {
      std::string msg="command is already loaded v." +dtos(mineserver-&gt;plugin.getPluginVersion(pluginName.c_str(),pluginName.size()));
      mineserver-&gt;screen.log(msg.c_str(),msg.size());
      return;
    }
    std::string msg="Loaded "+pluginName+"!";
    mineserver-&gt;screen.log(msg.c_str(),msg.size());
    mineserver-&gt;plugin.setPluginVersion(pluginName.c_str(),pluginName.size(), PLUGIN_COMMAND_VERSION);
    std::string hookName="ChatPre";
    mineserver-&gt;callback.add_hook(hookName.c_str(),hookName.size(), (void *)SOMEFUNCTIONNAME);
    hookName = "BlockPlacePre";
    mineserver-&gt;callback.add_hook(hookName.c_str(),hookName.size(), (void *)SOMEFUNCTIONNAME2);
  }
  PLUGIN_API_EXPORT void (plugin_name)_shutdown(void)
  {
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str(),pluginName.size()) &lt;= 0)
    {
      std::string msg="command is not loaded!";
      mineserver-&gt;screen.log(msg.c_str(),msg.size());
      return;
    }
  }
&lt;/code&gt;

==Available functions==


===Mineserver===

====Chat====


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''sendmsgTo'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | userLen
| class="col2" | size_t
| class="col3" | Length of username
|- class="row4"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in char array
|- class="row5"
| class="col1" | msgLen
| class="col2" | size_t
| class="col3" | length of the message
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, telling it the user was found
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''sendmsg'''
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in char array
|- class="row2"
| class="col1" | msgLen
| class="col2" | size_t
| class="col3" | length of the message
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, telling it the user was found
|}

====Screen====

{| class="wikitable"
|-
! Function
! Parameters
! Return value
|-
| '''log'''
| (std::string message)
| none
|-
| colspan="3" | Prints message to server window
|}


====Map====

{| class="wikitable"
|-
! Function
! Parameters
! Return value
|-
| '''createPickupSpawn'''
| (int x, int y, int z, int type, int count, int health, std::string user)
| none
|-
| colspan="3" | Spawns an item at (x,y,z) with type,count and health specified. If "user" is set, he will not be able to pick up the item right away to make it possible to throw stuff away.
|-
| '''setTime'''
| (std::string timeValue)
| bool
|-
| colspan="3" | Sets server time to timeValue, which can be a string of value 0-24000
|-
| '''getSpawn'''
| (int* x, int* y, int* z)
| void
|-
| colspan="3" | Gets server spawn position
|-
| '''getBlock'''
| (int x, int y, int z, unsigned char* type,unsigned char* meta)
| bool
|-
| colspan="3" | Get block type and metadata (absolute block coordinates)
|-
| '''setBlock'''
| (int x, int y, int z, unsigned char type,unsigned char meta)
| bool
|-
| colspan="3" | Set block type and metadata (absolute block coordinates)
|}

==Available callbacks==


{| class="wikitable"
|-
! Name
! Parameters
! Return value
|-
| '''ChatPre'''
| const std::string&amp; nick, std::string msg
| bool
|-
| colspan="3" | called on chat message prosessing, returning false will terminate the callback.
|-
| '''BlockPlacePre'''
| const std::string&amp; nick, int x,char y,int z,char block
| bool
|-
| colspan="3" | called on block placement, returning false will prevent block placement and terminate callback.
|-
| '''BlockBreakPre'''
| (int* x, int* y, int* z)
| bool
|-
| colspan="3" | called on block break, returning false will prevent block breaking and terminate callback.
|}</text>
    <sha1>936fd671459917efb283101662e117e36142f85d</sha1>
  </revision>
  <revision>
    <id>85</id>
    <parentid>84</parentid>
    <timestamp>2011-01-06T23:57:06Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <comment>new format..</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="8291" xml:space="preserve">Mineserver uses a C-plugin API which is described in this page.

==Creating a plugin==

You will need to include &lt;code&gt;plugin_api.h&lt;/code&gt; to your project.

...write some more stuff here...

Example plugin structure:

&lt;code&gt;
  #include "plugin_api.h"
  #define PLUGIN_VERSION 1.0
  std::string dtos( double n )
  {
    std::ostringstream result;
    result &lt;&lt; n;
    return result.str();
  }
  mineserver_pointer_struct* mineserver;
  std::string pluginName = "command";
  PLUGIN_API_EXPORT void (plugin_name)_init(mineserver_pointer_struct* mineserver_temp)
  {
    mineserver = mineserver_temp;
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str(),pluginName.size()) &gt; 0)
    {
      std::string msg="command is already loaded v." +dtos(mineserver-&gt;plugin.getPluginVersion(pluginName.c_str(),pluginName.size()));
      mineserver-&gt;screen.log(msg.c_str(),msg.size());
      return;
    }
    std::string msg="Loaded "+pluginName+"!";
    mineserver-&gt;screen.log(msg.c_str(),msg.size());
    mineserver-&gt;plugin.setPluginVersion(pluginName.c_str(),pluginName.size(), PLUGIN_COMMAND_VERSION);
    std::string hookName="ChatPre";
    mineserver-&gt;callback.add_hook(hookName.c_str(),hookName.size(), (void *)SOMEFUNCTIONNAME);
    hookName = "BlockPlacePre";
    mineserver-&gt;callback.add_hook(hookName.c_str(),hookName.size(), (void *)SOMEFUNCTIONNAME2);
  }
  PLUGIN_API_EXPORT void (plugin_name)_shutdown(void)
  {
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str(),pluginName.size()) &lt;= 0)
    {
      std::string msg="command is not loaded!";
      mineserver-&gt;screen.log(msg.c_str(),msg.size());
      return;
    }
  }
&lt;/code&gt;

==Available functions==


===Mineserver===

====Chat====


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''sendmsgTo'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | userLen
| class="col2" | size_t
| class="col3" | Length of username
|- class="row4"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in char array
|- class="row5"
| class="col1" | msgLen
| class="col2" | size_t
| class="col3" | length of the message
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, telling it the user was found
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="2" | '''sendmsg'''
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in char array
|- class="row2"
| class="col1" | msgLen
| class="col2" | size_t
| class="col3" | length of the message
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, telling it the user was found
|}

====Screen====

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="2" | '''log'''
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in char array
|- class="row2"
| class="col1" | msgLen
| class="col2" | size_t
| class="col3" | length of the message
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row8"
| class="col0" colspan="4" | Prints message to server window
|}

====Map====


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="7" | '''createPickupSpawn'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | count
| class="col2" | int
| class="col3" | How many to spawn (1-64)
|- class="row4"
| class="col1" | health
| class="col2" | int
| class="col3" | item health (0 = full health, max value depends on the item)
|- class="row5"
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username
|- class="row6"
| class="col1" | userLen
| class="col2" | size_t
| class="col3" | Length of username
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row8"
| class="col0" colspan="4" | Spawns an item at (x,y,z) with type,count and health specified. If "user" is set, he will not be able to pick up the item right away to make it possible to throw stuff away.
|}


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''setTime'''
| class="col1" | timeValue
| class="col2" | int
| class="col3" | value 0-24000
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row3"
| class="col0" colspan="4" | Sets server time to timeValue, which can be in range 0-24000
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''getSpawn'''
| class="col1" | x
| class="col2" | int*
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int*
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int*
| class="col3" | z-coordinate
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row5"
| class="col0" colspan="4" | Gets server spawn position
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''getBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Get block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''setBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Set block type and metadata (absolute block coordinates)
|}

==Available callbacks==


{| class="wikitable"
|-
! Name
! Parameters
! Return value
|-
| '''ChatPre'''
| const std::string&amp; nick, std::string msg
| bool
|-
| colspan="3" | called on chat message prosessing, returning false will terminate the callback.
|-
| '''BlockPlacePre'''
| const std::string&amp; nick, int x,char y,int z,char block
| bool
|-
| colspan="3" | called on block placement, returning false will prevent block placement and terminate callback.
|-
| '''BlockBreakPre'''
| (int* x, int* y, int* z)
| bool
|-
| colspan="3" | called on block break, returning false will prevent block breaking and terminate callback.
|}</text>
    <sha1>9213387e968d76edd822d4272169c8f5bcd212e9</sha1>
  </revision>
  <revision>
    <id>86</id>
    <parentid>85</parentid>
    <timestamp>2011-01-07T00:03:15Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <comment>callback formatted.</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="10387" xml:space="preserve">Mineserver uses a C-plugin API which is described in this page.

==Creating a plugin==

You will need to include &lt;code&gt;plugin_api.h&lt;/code&gt; to your project.

...write some more stuff here...

Example plugin structure:

&lt;code&gt;
  #include "plugin_api.h"
  #define PLUGIN_VERSION 1.0
  std::string dtos( double n )
  {
    std::ostringstream result;
    result &lt;&lt; n;
    return result.str();
  }
  mineserver_pointer_struct* mineserver;
  std::string pluginName = "command";
  PLUGIN_API_EXPORT void (plugin_name)_init(mineserver_pointer_struct* mineserver_temp)
  {
    mineserver = mineserver_temp;
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str(),pluginName.size()) &gt; 0)
    {
      std::string msg="command is already loaded v." +dtos(mineserver-&gt;plugin.getPluginVersion(pluginName.c_str(),pluginName.size()));
      mineserver-&gt;screen.log(msg.c_str(),msg.size());
      return;
    }
    std::string msg="Loaded "+pluginName+"!";
    mineserver-&gt;screen.log(msg.c_str(),msg.size());
    mineserver-&gt;plugin.setPluginVersion(pluginName.c_str(),pluginName.size(), PLUGIN_COMMAND_VERSION);
    std::string hookName="ChatPre";
    mineserver-&gt;callback.add_hook(hookName.c_str(),hookName.size(), (void *)SOMEFUNCTIONNAME);
    hookName = "BlockPlacePre";
    mineserver-&gt;callback.add_hook(hookName.c_str(),hookName.size(), (void *)SOMEFUNCTIONNAME2);
  }
  PLUGIN_API_EXPORT void (plugin_name)_shutdown(void)
  {
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str(),pluginName.size()) &lt;= 0)
    {
      std::string msg="command is not loaded!";
      mineserver-&gt;screen.log(msg.c_str(),msg.size());
      return;
    }
  }
&lt;/code&gt;

==Available functions==


===Mineserver===

====Chat====


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''sendmsgTo'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | userLen
| class="col2" | size_t
| class="col3" | Length of username
|- class="row4"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in char array
|- class="row5"
| class="col1" | msgLen
| class="col2" | size_t
| class="col3" | length of the message
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, telling it the user was found
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="2" | '''sendmsg'''
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in char array
|- class="row2"
| class="col1" | msgLen
| class="col2" | size_t
| class="col3" | length of the message
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, telling it the user was found
|}

====Screen====

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="2" | '''log'''
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in char array
|- class="row2"
| class="col1" | msgLen
| class="col2" | size_t
| class="col3" | length of the message
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row8"
| class="col0" colspan="4" | Prints message to server window
|}

====Map====


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="7" | '''createPickupSpawn'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | count
| class="col2" | int
| class="col3" | How many to spawn (1-64)
|- class="row4"
| class="col1" | health
| class="col2" | int
| class="col3" | item health (0 = full health, max value depends on the item)
|- class="row5"
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username
|- class="row6"
| class="col1" | userLen
| class="col2" | size_t
| class="col3" | Length of username
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row8"
| class="col0" colspan="4" | Spawns an item at (x,y,z) with type,count and health specified. If "user" is set, he will not be able to pick up the item right away to make it possible to throw stuff away.
|}


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''setTime'''
| class="col1" | timeValue
| class="col2" | int
| class="col3" | value 0-24000
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row3"
| class="col0" colspan="4" | Sets server time to timeValue, which can be in range 0-24000
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''getSpawn'''
| class="col1" | x
| class="col2" | int*
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int*
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int*
| class="col3" | z-coordinate
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row5"
| class="col0" colspan="4" | Gets server spawn position
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''getBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Get block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''setBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Set block type and metadata (absolute block coordinates)
|}

==Available callbacks==


{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''ChatPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | userLen
| class="col2" | size_t
| class="col3" | Length of username
|- class="row4"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in char array
|- class="row5"
| class="col1" | msgLen
| class="col2" | size_t
| class="col3" | Length of the message
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | called on chat message prosessing, returning false will terminate the callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''BlockPlacePre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | userLen
| class="col2" | size_t
| class="col3" | Length of username
|- class="row4"
| class="col1" | x
| class="col2" | int
| class="col3" | x-coord
|- class="row5"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coord
|- class="row6"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coord
|- class="row7"
| class="col1" | block
| class="col2" | char
| class="col3" | block type
|- class="row8"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row9"
| class="col0" colspan="4" | called on block placement, returning false will prevent block placement and terminate callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''BlockBreakPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | userLen
| class="col2" | size_t
| class="col3" | Length of username
|- class="row4"
| class="col1" | x
| class="col2" | int
| class="col3" | x-coord
|- class="row5"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coord
|- class="row6"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coord
|- class="row8"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row9"
| class="col0" colspan="4" | called on block break, returning false will prevent block breaking and terminate callback.
|}</text>
    <sha1>f36dbefa607f4614df70b2847d9587d3a0a8ee58</sha1>
  </revision>
  <revision>
    <id>87</id>
    <parentid>86</parentid>
    <timestamp>2011-01-07T01:26:20Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="9330" xml:space="preserve">Mineserver uses a C-plugin API which is described in this page.

==Creating a plugin==

You will need to include &lt;code&gt;plugin_api.h&lt;/code&gt; to your project.

...write some more stuff here...

Example plugin structure:

&lt;code&gt;
  #include "plugin_api.h"
  #define PLUGIN_VERSION 1.0
  std::string dtos( double n )
  {
    std::ostringstream result;
    result &lt;&lt; n;
    return result.str();
  }
  mineserver_pointer_struct* mineserver;
  std::string pluginName = "command";
  PLUGIN_API_EXPORT void (plugin_name)_init(mineserver_pointer_struct* mineserver_temp)
  {
    mineserver = mineserver_temp;
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()) &gt; 0)
    {
      std::string msg="command is already loaded v." +dtos(mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()));
      mineserver-&gt;screen.log(msg.c_str(),msg.size());
      return;
    }
    std::string msg="Loaded "+pluginName+"!";
    mineserver-&gt;screen.log(msg.c_str());
    mineserver-&gt;plugin.setPluginVersion(pluginName.c_str(), PLUGIN_COMMAND_VERSION);
    mineserver-&gt;callback.add_hook("ChatPre", (void *)SOMEFUNCTIONNAME);
    mineserver-&gt;callback.add_hook("BlockPlacePre", (void *)SOMEFUNCTIONNAME2);
  }
  PLUGIN_API_EXPORT void (plugin_name)_shutdown(void)
  {
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()) &lt;= 0)
    {
      mineserver-&gt;screen.log("command is not loaded!"));
      return;
    }
  }
&lt;/code&gt;

==Available functions==


===Mineserver===

====Chat====


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="2" | '''sendmsgTo'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, telling it the user was found
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''sendmsg'''
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, telling it the user was found
|}

====Screen====

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''log'''
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row3"
| class="col0" colspan="4" | Prints message to server window
|}

====Map====


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''createPickupSpawn'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | count
| class="col2" | int
| class="col3" | How many to spawn (1-64)
|- class="row4"
| class="col1" | health
| class="col2" | int
| class="col3" | item health (0 = full health, max value depends on the item)
|- class="row5"
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row7"
| class="col0" colspan="4" | Spawns an item at (x,y,z) with type,count and health specified. If "user" is set, he will not be able to pick up the item right away to make it possible to throw stuff away.
|}


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''setTime'''
| class="col1" | timeValue
| class="col2" | int
| class="col3" | value 0-24000
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row3"
| class="col0" colspan="4" | Sets server time to timeValue, which can be in range 0-24000
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''getSpawn'''
| class="col1" | x
| class="col2" | int*
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int*
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int*
| class="col3" | z-coordinate
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row5"
| class="col0" colspan="4" | Gets server spawn position
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''getBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Get block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''setBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Set block type and metadata (absolute block coordinates)
|}

==Available callbacks==


{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="2" | '''ChatPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row4"
| class="col0" colspan="4" | called on chat message prosessing, returning false will terminate the callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''BlockPlacePre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coord
|- class="row5"
| class="col1" | block
| class="col2" | char
| class="col3" | block type
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | called on block placement, returning false will prevent block placement and terminate callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''BlockBreakPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coord
|- class="row5"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row6"
| class="col0" colspan="4" | called on block break, returning false will prevent block breaking and terminate callback.
|}</text>
    <sha1>a6bb3cc28cd8dfff4815e6be08db419ada9ea94e</sha1>
  </revision>
  <revision>
    <id>89</id>
    <parentid>87</parentid>
    <timestamp>2011-01-08T20:35:08Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <minor/>
    <comment>/* Available callbacks */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="9434" xml:space="preserve">Mineserver uses a C-plugin API which is described in this page.

==Creating a plugin==

You will need to include &lt;code&gt;plugin_api.h&lt;/code&gt; to your project.

...write some more stuff here...

Example plugin structure:

&lt;code&gt;
  #include "plugin_api.h"
  #define PLUGIN_VERSION 1.0
  std::string dtos( double n )
  {
    std::ostringstream result;
    result &lt;&lt; n;
    return result.str();
  }
  mineserver_pointer_struct* mineserver;
  std::string pluginName = "command";
  PLUGIN_API_EXPORT void (plugin_name)_init(mineserver_pointer_struct* mineserver_temp)
  {
    mineserver = mineserver_temp;
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()) &gt; 0)
    {
      std::string msg="command is already loaded v." +dtos(mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()));
      mineserver-&gt;screen.log(msg.c_str(),msg.size());
      return;
    }
    std::string msg="Loaded "+pluginName+"!";
    mineserver-&gt;screen.log(msg.c_str());
    mineserver-&gt;plugin.setPluginVersion(pluginName.c_str(), PLUGIN_COMMAND_VERSION);
    mineserver-&gt;callback.add_hook("ChatPre", (void *)SOMEFUNCTIONNAME);
    mineserver-&gt;callback.add_hook("BlockPlacePre", (void *)SOMEFUNCTIONNAME2);
  }
  PLUGIN_API_EXPORT void (plugin_name)_shutdown(void)
  {
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()) &lt;= 0)
    {
      mineserver-&gt;screen.log("command is not loaded!"));
      return;
    }
  }
&lt;/code&gt;

==Available functions==


===Mineserver===

====Chat====


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="2" | '''sendmsgTo'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, telling it the user was found
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''sendmsg'''
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, telling it the user was found
|}

====Screen====

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''log'''
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row3"
| class="col0" colspan="4" | Prints message to server window
|}

====Map====


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''createPickupSpawn'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | count
| class="col2" | int
| class="col3" | How many to spawn (1-64)
|- class="row4"
| class="col1" | health
| class="col2" | int
| class="col3" | item health (0 = full health, max value depends on the item)
|- class="row5"
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row7"
| class="col0" colspan="4" | Spawns an item at (x,y,z) with type,count and health specified. If "user" is set, he will not be able to pick up the item right away to make it possible to throw stuff away.
|}


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''setTime'''
| class="col1" | timeValue
| class="col2" | int
| class="col3" | value 0-24000
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row3"
| class="col0" colspan="4" | Sets server time to timeValue, which can be in range 0-24000
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''getSpawn'''
| class="col1" | x
| class="col2" | int*
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int*
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int*
| class="col3" | z-coordinate
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row5"
| class="col0" colspan="4" | Gets server spawn position
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''getBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Get block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''setBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Set block type and metadata (absolute block coordinates)
|}

==Available callbacks==


{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''ChatPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | timestamp
| class="col2" | size_t
| class="col3" | time of the message
|- class="row2"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row4"
| class="col0" colspan="4" | called on chat message prosessing, returning false will terminate the callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''BlockPlacePre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coord
|- class="row5"
| class="col1" | block
| class="col2" | char
| class="col3" | block type
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | called on block placement, returning false will prevent block placement and terminate callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''BlockBreakPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coord
|- class="row5"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row6"
| class="col0" colspan="4" | called on block break, returning false will prevent block breaking and terminate callback.
|}</text>
    <sha1>b95719c58bcc64f5a9a4a67cf52ad61399e827be</sha1>
  </revision>
  <revision>
    <id>90</id>
    <parentid>89</parentid>
    <timestamp>2011-01-08T22:30:38Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <comment>/* Available callbacks */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="12522" xml:space="preserve">Mineserver uses a C-plugin API which is described in this page.

==Creating a plugin==

You will need to include &lt;code&gt;plugin_api.h&lt;/code&gt; to your project.

...write some more stuff here...

Example plugin structure:

&lt;code&gt;
  #include "plugin_api.h"
  #define PLUGIN_VERSION 1.0
  std::string dtos( double n )
  {
    std::ostringstream result;
    result &lt;&lt; n;
    return result.str();
  }
  mineserver_pointer_struct* mineserver;
  std::string pluginName = "command";
  PLUGIN_API_EXPORT void (plugin_name)_init(mineserver_pointer_struct* mineserver_temp)
  {
    mineserver = mineserver_temp;
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()) &gt; 0)
    {
      std::string msg="command is already loaded v." +dtos(mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()));
      mineserver-&gt;screen.log(msg.c_str(),msg.size());
      return;
    }
    std::string msg="Loaded "+pluginName+"!";
    mineserver-&gt;screen.log(msg.c_str());
    mineserver-&gt;plugin.setPluginVersion(pluginName.c_str(), PLUGIN_COMMAND_VERSION);
    mineserver-&gt;callback.add_hook("ChatPre", (void *)SOMEFUNCTIONNAME);
    mineserver-&gt;callback.add_hook("BlockPlacePre", (void *)SOMEFUNCTIONNAME2);
  }
  PLUGIN_API_EXPORT void (plugin_name)_shutdown(void)
  {
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()) &lt;= 0)
    {
      mineserver-&gt;screen.log("command is not loaded!"));
      return;
    }
  }
&lt;/code&gt;

==Available functions==


===Mineserver===

====Chat====


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="2" | '''sendmsgTo'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, telling it the user was found
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''sendmsg'''
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, telling it the user was found
|}

====Screen====

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''log'''
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row3"
| class="col0" colspan="4" | Prints message to server window
|}

====Map====


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''createPickupSpawn'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | count
| class="col2" | int
| class="col3" | How many to spawn (1-64)
|- class="row4"
| class="col1" | health
| class="col2" | int
| class="col3" | item health (0 = full health, max value depends on the item)
|- class="row5"
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row7"
| class="col0" colspan="4" | Spawns an item at (x,y,z) with type,count and health specified. If "user" is set, he will not be able to pick up the item right away to make it possible to throw stuff away.
|}


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''setTime'''
| class="col1" | timeValue
| class="col2" | int
| class="col3" | value 0-24000
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row3"
| class="col0" colspan="4" | Sets server time to timeValue, which can be in range 0-24000
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''getSpawn'''
| class="col1" | x
| class="col2" | int*
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int*
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int*
| class="col3" | z-coordinate
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row5"
| class="col0" colspan="4" | Gets server spawn position
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''getBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Get block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''setBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Set block type and metadata (absolute block coordinates)
|}

==Available callbacks==


{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer200'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 200ms timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer1000'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 1000ms (1s) timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer10000'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 10s timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''PlayerChatPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | timestamp
| class="col2" | size_t
| class="col3" | time of the message
|- class="row2"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row4"
| class="col0" colspan="4" | called on chat message prosessing, returning false will terminate the callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''BlockPlacePre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coord
|- class="row5"
| class="col1" | block
| class="col2" | char
| class="col3" | block type
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | called on block placement, returning false will prevent block placement and terminate callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''BlockBreakPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coord
|- class="row5"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row6"
| class="col0" colspan="4" | called on block break, returning false will prevent block breaking and terminate callback.
|}


ToDo:

    setHook("PlayerLoginPre", new Hook2&lt;bool,const char*,char***&gt;);
    setHook("PlayerLoginPost", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerNickPost", new Hook2&lt;bool,const char*,const char*&gt;);
    setHook("PlayerKickPost", new Hook2&lt;bool,const char*,const char*&gt;);
    setHook("PlayerQuitPost", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerChatPost", new Hook3&lt;bool,const char*,time_t,const char*&gt;);
    setHook("PlayerArmSwing", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerDamagePre", new Hook3&lt;bool,const char*,const char*,int&gt;);
    setHook("PlayerDamagePost", new Hook3&lt;bool,const char*,const char*,int&gt;);
    setHook("PlayerDisconnect", new Hook3&lt;bool,const char*,uint32,uint16&gt;);
    setHook("PlayerDiggingStarted", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("PlayerDigging", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("PlayerDiggingStopped", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockBreakPre", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockBreakPost", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockNeighbourBreak", new Hook7&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32&gt;);
    setHook("BlockPlacePre", new Hook5&lt;bool,const char*,sint32,sint8,sint32,sint16&gt;);
    setHook("BlockPlacePost", new Hook5&lt;bool,const char*,sint32,sint8,sint32,sint16&gt;);
    setHook("BlockNeighbourPlace", new Hook7&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32&gt;);
    setHook("BlockReplacePost", new Hook6&lt;bool,const char*,sint32,sint8,sint32,sint16,sint16&gt;);
    setHook("BlockNeighbourReplace", new Hook9&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32,sint16,sint16&gt;);</text>
    <sha1>5a64e097db9349fe771090d060d35335a724336a</sha1>
  </revision>
  <revision>
    <id>91</id>
    <parentid>90</parentid>
    <timestamp>2011-01-08T22:31:19Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <minor/>
    <comment>/* Creating a plugin */ example update</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="12530" xml:space="preserve">Mineserver uses a C-plugin API which is described in this page.

==Creating a plugin==

You will need to include &lt;code&gt;plugin_api.h&lt;/code&gt; to your project.

...write some more stuff here...

Example plugin structure:

&lt;code&gt;
  #include "plugin_api.h"
  #define PLUGIN_VERSION 1.0
  std::string dtos( double n )
  {
    std::ostringstream result;
    result &lt;&lt; n;
    return result.str();
  }
  mineserver_pointer_struct* mineserver;
  std::string pluginName = "command";
  PLUGIN_API_EXPORT void (plugin_name)_init(mineserver_pointer_struct* mineserver_temp)
  {
    mineserver = mineserver_temp;
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()) &gt; 0)
    {
      std::string msg="command is already loaded v." +dtos(mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()));
      mineserver-&gt;screen.log(msg.c_str(),msg.size());
      return;
    }
    std::string msg="Loaded "+pluginName+"!";
    mineserver-&gt;screen.log(msg.c_str());
    mineserver-&gt;plugin.setPluginVersion(pluginName.c_str(), PLUGIN_COMMAND_VERSION);
    mineserver-&gt;plugin.addCallback("PlayerChatPre", (void *)SOMEFUNCTIONNAME);
    mineserver-&gt;plugin.addCallback("BlockPlacePre", (void *)SOMEFUNCTIONNAME2);
  }
  PLUGIN_API_EXPORT void (plugin_name)_shutdown(void)
  {
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()) &lt;= 0)
    {
      mineserver-&gt;screen.log("command is not loaded!"));
      return;
    }
  }
&lt;/code&gt;

==Available functions==


===Mineserver===

====Chat====


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="2" | '''sendmsgTo'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, telling it the user was found
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''sendmsg'''
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, telling it the user was found
|}

====Screen====

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''log'''
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row3"
| class="col0" colspan="4" | Prints message to server window
|}

====Map====


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''createPickupSpawn'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | count
| class="col2" | int
| class="col3" | How many to spawn (1-64)
|- class="row4"
| class="col1" | health
| class="col2" | int
| class="col3" | item health (0 = full health, max value depends on the item)
|- class="row5"
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row7"
| class="col0" colspan="4" | Spawns an item at (x,y,z) with type,count and health specified. If "user" is set, he will not be able to pick up the item right away to make it possible to throw stuff away.
|}


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''setTime'''
| class="col1" | timeValue
| class="col2" | int
| class="col3" | value 0-24000
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row3"
| class="col0" colspan="4" | Sets server time to timeValue, which can be in range 0-24000
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''getSpawn'''
| class="col1" | x
| class="col2" | int*
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int*
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int*
| class="col3" | z-coordinate
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row5"
| class="col0" colspan="4" | Gets server spawn position
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''getBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Get block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''setBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Set block type and metadata (absolute block coordinates)
|}

==Available callbacks==


{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer200'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 200ms timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer1000'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 1000ms (1s) timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer10000'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 10s timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''PlayerChatPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | timestamp
| class="col2" | size_t
| class="col3" | time of the message
|- class="row2"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row4"
| class="col0" colspan="4" | called on chat message prosessing, returning false will terminate the callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''BlockPlacePre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coord
|- class="row5"
| class="col1" | block
| class="col2" | char
| class="col3" | block type
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | called on block placement, returning false will prevent block placement and terminate callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''BlockBreakPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coord
|- class="row5"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row6"
| class="col0" colspan="4" | called on block break, returning false will prevent block breaking and terminate callback.
|}


ToDo:

    setHook("PlayerLoginPre", new Hook2&lt;bool,const char*,char***&gt;);
    setHook("PlayerLoginPost", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerNickPost", new Hook2&lt;bool,const char*,const char*&gt;);
    setHook("PlayerKickPost", new Hook2&lt;bool,const char*,const char*&gt;);
    setHook("PlayerQuitPost", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerChatPost", new Hook3&lt;bool,const char*,time_t,const char*&gt;);
    setHook("PlayerArmSwing", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerDamagePre", new Hook3&lt;bool,const char*,const char*,int&gt;);
    setHook("PlayerDamagePost", new Hook3&lt;bool,const char*,const char*,int&gt;);
    setHook("PlayerDisconnect", new Hook3&lt;bool,const char*,uint32,uint16&gt;);
    setHook("PlayerDiggingStarted", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("PlayerDigging", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("PlayerDiggingStopped", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockBreakPre", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockBreakPost", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockNeighbourBreak", new Hook7&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32&gt;);
    setHook("BlockPlacePre", new Hook5&lt;bool,const char*,sint32,sint8,sint32,sint16&gt;);
    setHook("BlockPlacePost", new Hook5&lt;bool,const char*,sint32,sint8,sint32,sint16&gt;);
    setHook("BlockNeighbourPlace", new Hook7&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32&gt;);
    setHook("BlockReplacePost", new Hook6&lt;bool,const char*,sint32,sint8,sint32,sint16,sint16&gt;);
    setHook("BlockNeighbourReplace", new Hook9&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32,sint16,sint16&gt;);</text>
    <sha1>9932eb5a6c85026060a80c2eca91573d796a6940</sha1>
  </revision>
  <revision>
    <id>92</id>
    <parentid>91</parentid>
    <timestamp>2011-01-10T23:05:28Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <minor/>
    <comment>/* Available callbacks */ BlockPlacePre update</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="12648" xml:space="preserve">Mineserver uses a C-plugin API which is described in this page.

==Creating a plugin==

You will need to include &lt;code&gt;plugin_api.h&lt;/code&gt; to your project.

...write some more stuff here...

Example plugin structure:

&lt;code&gt;
  #include "plugin_api.h"
  #define PLUGIN_VERSION 1.0
  std::string dtos( double n )
  {
    std::ostringstream result;
    result &lt;&lt; n;
    return result.str();
  }
  mineserver_pointer_struct* mineserver;
  std::string pluginName = "command";
  PLUGIN_API_EXPORT void (plugin_name)_init(mineserver_pointer_struct* mineserver_temp)
  {
    mineserver = mineserver_temp;
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()) &gt; 0)
    {
      std::string msg="command is already loaded v." +dtos(mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()));
      mineserver-&gt;screen.log(msg.c_str(),msg.size());
      return;
    }
    std::string msg="Loaded "+pluginName+"!";
    mineserver-&gt;screen.log(msg.c_str());
    mineserver-&gt;plugin.setPluginVersion(pluginName.c_str(), PLUGIN_COMMAND_VERSION);
    mineserver-&gt;plugin.addCallback("PlayerChatPre", (void *)SOMEFUNCTIONNAME);
    mineserver-&gt;plugin.addCallback("BlockPlacePre", (void *)SOMEFUNCTIONNAME2);
  }
  PLUGIN_API_EXPORT void (plugin_name)_shutdown(void)
  {
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()) &lt;= 0)
    {
      mineserver-&gt;screen.log("command is not loaded!"));
      return;
    }
  }
&lt;/code&gt;

==Available functions==


===Mineserver===

====Chat====


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="2" | '''sendmsgTo'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, telling it the user was found
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''sendmsg'''
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, telling it the user was found
|}

====Screen====

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''log'''
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row3"
| class="col0" colspan="4" | Prints message to server window
|}

====Map====


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''createPickupSpawn'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | count
| class="col2" | int
| class="col3" | How many to spawn (1-64)
|- class="row4"
| class="col1" | health
| class="col2" | int
| class="col3" | item health (0 = full health, max value depends on the item)
|- class="row5"
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row7"
| class="col0" colspan="4" | Spawns an item at (x,y,z) with type,count and health specified. If "user" is set, he will not be able to pick up the item right away to make it possible to throw stuff away.
|}


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''setTime'''
| class="col1" | timeValue
| class="col2" | int
| class="col3" | value 0-24000
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row3"
| class="col0" colspan="4" | Sets server time to timeValue, which can be in range 0-24000
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''getSpawn'''
| class="col1" | x
| class="col2" | int*
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int*
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int*
| class="col3" | z-coordinate
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row5"
| class="col0" colspan="4" | Gets server spawn position
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''getBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Get block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''setBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Set block type and metadata (absolute block coordinates)
|}

==Available callbacks==


{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer200'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 200ms timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer1000'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 1000ms (1s) timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer10000'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 10s timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''PlayerChatPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | timestamp
| class="col2" | size_t
| class="col3" | time of the message
|- class="row2"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row4"
| class="col0" colspan="4" | called on chat message prosessing, returning false will terminate the callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''BlockPlacePre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int32_t
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int8_t
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int32_t
| class="col3" | z-coord
|- class="row5"
| class="col1" | block
| class="col2" | int16_t
| class="col3" | block type
|- class="row6"
| class="col1" | direction
| class="col2" | int8_t
| class="col3" | placement direction
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row8"
| class="col0" colspan="4" | called on block placement, returning false will prevent block placement and terminate callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''BlockBreakPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coord
|- class="row5"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row6"
| class="col0" colspan="4" | called on block break, returning false will prevent block breaking and terminate callback.
|}


ToDo:

    setHook("PlayerLoginPre", new Hook2&lt;bool,const char*,char***&gt;);
    setHook("PlayerLoginPost", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerNickPost", new Hook2&lt;bool,const char*,const char*&gt;);
    setHook("PlayerKickPost", new Hook2&lt;bool,const char*,const char*&gt;);
    setHook("PlayerQuitPost", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerChatPost", new Hook3&lt;bool,const char*,time_t,const char*&gt;);
    setHook("PlayerArmSwing", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerDamagePre", new Hook3&lt;bool,const char*,const char*,int&gt;);
    setHook("PlayerDamagePost", new Hook3&lt;bool,const char*,const char*,int&gt;);
    setHook("PlayerDisconnect", new Hook3&lt;bool,const char*,uint32,uint16&gt;);
    setHook("PlayerDiggingStarted", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("PlayerDigging", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("PlayerDiggingStopped", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockBreakPre", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockBreakPost", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockNeighbourBreak", new Hook7&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32&gt;);
    setHook("BlockPlacePre", new Hook5&lt;bool,const char*,sint32,sint8,sint32,sint16&gt;);
    setHook("BlockPlacePost", new Hook5&lt;bool,const char*,sint32,sint8,sint32,sint16&gt;);
    setHook("BlockNeighbourPlace", new Hook7&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32&gt;);
    setHook("BlockReplacePost", new Hook6&lt;bool,const char*,sint32,sint8,sint32,sint16,sint16&gt;);
    setHook("BlockNeighbourReplace", new Hook9&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32,sint16,sint16&gt;);</text>
    <sha1>007a56e066772ee8bbee4c1210d522bbf88f1ce9</sha1>
  </revision>
  <revision>
    <id>100</id>
    <parentid>92</parentid>
    <timestamp>2011-01-15T14:48:46Z</timestamp>
    <contributor>
      <username>Samuel-Sama</username>
      <id>15</id>
    </contributor>
    <minor/>
    <comment>/* Available callbacks */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="12648" xml:space="preserve">Mineserver uses a C-plugin API which is described in this page.

==Creating a plugin==

You will need to include &lt;code&gt;plugin_api.h&lt;/code&gt; to your project.

...write some more stuff here...

Example plugin structure:

&lt;code&gt;
  #include "plugin_api.h"
  #define PLUGIN_VERSION 1.0
  std::string dtos( double n )
  {
    std::ostringstream result;
    result &lt;&lt; n;
    return result.str();
  }
  mineserver_pointer_struct* mineserver;
  std::string pluginName = "command";
  PLUGIN_API_EXPORT void (plugin_name)_init(mineserver_pointer_struct* mineserver_temp)
  {
    mineserver = mineserver_temp;
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()) &gt; 0)
    {
      std::string msg="command is already loaded v." +dtos(mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()));
      mineserver-&gt;screen.log(msg.c_str(),msg.size());
      return;
    }
    std::string msg="Loaded "+pluginName+"!";
    mineserver-&gt;screen.log(msg.c_str());
    mineserver-&gt;plugin.setPluginVersion(pluginName.c_str(), PLUGIN_COMMAND_VERSION);
    mineserver-&gt;plugin.addCallback("PlayerChatPre", (void *)SOMEFUNCTIONNAME);
    mineserver-&gt;plugin.addCallback("BlockPlacePre", (void *)SOMEFUNCTIONNAME2);
  }
  PLUGIN_API_EXPORT void (plugin_name)_shutdown(void)
  {
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()) &lt;= 0)
    {
      mineserver-&gt;screen.log("command is not loaded!"));
      return;
    }
  }
&lt;/code&gt;

==Available functions==


===Mineserver===

====Chat====


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="2" | '''sendmsgTo'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, telling it the user was found
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''sendmsg'''
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, telling it the user was found
|}

====Screen====

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''log'''
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row3"
| class="col0" colspan="4" | Prints message to server window
|}

====Map====


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''createPickupSpawn'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | count
| class="col2" | int
| class="col3" | How many to spawn (1-64)
|- class="row4"
| class="col1" | health
| class="col2" | int
| class="col3" | item health (0 = full health, max value depends on the item)
|- class="row5"
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row7"
| class="col0" colspan="4" | Spawns an item at (x,y,z) with type,count and health specified. If "user" is set, he will not be able to pick up the item right away to make it possible to throw stuff away.
|}


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''setTime'''
| class="col1" | timeValue
| class="col2" | int
| class="col3" | value 0-24000
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row3"
| class="col0" colspan="4" | Sets server time to timeValue, which can be in range 0-24000
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''getSpawn'''
| class="col1" | x
| class="col2" | int*
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int*
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int*
| class="col3" | z-coordinate
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row5"
| class="col0" colspan="4" | Gets server spawn position
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''getBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Get block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''setBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Set block type and metadata (absolute block coordinates)
|}

==Available callbacks==


{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer200'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 200ms timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer1000'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 1000ms (1s) timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer10000'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 10s timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''PlayerChatPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | timestamp
| class="col2" | size_t
| class="col3" | time of the message
|- class="row2"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row4"
| class="col0" colspan="4" | called on chat message processing, returning false will terminate the callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''BlockPlacePre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int32_t
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int8_t
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int32_t
| class="col3" | z-coord
|- class="row5"
| class="col1" | block
| class="col2" | int16_t
| class="col3" | block type
|- class="row6"
| class="col1" | direction
| class="col2" | int8_t
| class="col3" | placement direction
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row8"
| class="col0" colspan="4" | called on block placement, returning false will prevent block placement and terminate callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''BlockBreakPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coord
|- class="row5"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row6"
| class="col0" colspan="4" | called on block break, returning false will prevent block breaking and terminate callback.
|}


ToDo:

    setHook("PlayerLoginPre", new Hook2&lt;bool,const char*,char***&gt;);
    setHook("PlayerLoginPost", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerNickPost", new Hook2&lt;bool,const char*,const char*&gt;);
    setHook("PlayerKickPost", new Hook2&lt;bool,const char*,const char*&gt;);
    setHook("PlayerQuitPost", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerChatPost", new Hook3&lt;bool,const char*,time_t,const char*&gt;);
    setHook("PlayerArmSwing", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerDamagePre", new Hook3&lt;bool,const char*,const char*,int&gt;);
    setHook("PlayerDamagePost", new Hook3&lt;bool,const char*,const char*,int&gt;);
    setHook("PlayerDisconnect", new Hook3&lt;bool,const char*,uint32,uint16&gt;);
    setHook("PlayerDiggingStarted", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("PlayerDigging", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("PlayerDiggingStopped", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockBreakPre", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockBreakPost", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockNeighbourBreak", new Hook7&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32&gt;);
    setHook("BlockPlacePre", new Hook5&lt;bool,const char*,sint32,sint8,sint32,sint16&gt;);
    setHook("BlockPlacePost", new Hook5&lt;bool,const char*,sint32,sint8,sint32,sint16&gt;);
    setHook("BlockNeighbourPlace", new Hook7&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32&gt;);
    setHook("BlockReplacePost", new Hook6&lt;bool,const char*,sint32,sint8,sint32,sint16,sint16&gt;);
    setHook("BlockNeighbourReplace", new Hook9&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32,sint16,sint16&gt;);</text>
    <sha1>bb322b631ab470a1afa3be02721afd665ee38df9</sha1>
  </revision>
</page>
<page arvcontinue="20101206223208|51">
  <title>Main Page</title>
  <ns>0</ns>
  <id>1</id>
  <revision>
    <id>74</id>
    <parentid>45</parentid>
    <timestamp>2010-12-29T19:15:56Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <minor/>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="628" xml:space="preserve">Hi there! Welcome to the Mineserver wiki. Below is a list of articles that may or may not need writing. This page will be fleshed out when we have some more content here.

If you feel like creating, fixing and/or adding anything, you can log in with your forum account. If you don't yet have a forum account, you can create one [http://mineserver.be/forums/ here]. This wiki will become publicly editable when there are a few more users and we have some spam/vandal control in place.

* [[Installation]]
* [[Configuration]]
* [[Commands]]
* [[Frequently Asked Questions]]
* [[Advanced Usage]]
* [[Coding Style]]
* [[Plugin_API]]</text>
    <sha1>b9b32985f2478f567d71bd7d39f499cb73d04b5a</sha1>
  </revision>
  <revision>
    <id>75</id>
    <parentid>74</parentid>
    <timestamp>2010-12-29T19:16:06Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <minor/>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="628" xml:space="preserve">Hi there! Welcome to the Mineserver wiki. Below is a list of articles that may or may not need writing. This page will be fleshed out when we have some more content here.

If you feel like creating, fixing and/or adding anything, you can log in with your forum account. If you don't yet have a forum account, you can create one [http://mineserver.be/forums/ here]. This wiki will become publicly editable when there are a few more users and we have some spam/vandal control in place.

* [[Installation]]
* [[Configuration]]
* [[Commands]]
* [[Frequently Asked Questions]]
* [[Advanced Usage]]
* [[Coding Style]]
* [[Plugin API]]</text>
    <sha1>ec0829532cbf1c11c72d473435bb7ff95619fe1b</sha1>
  </revision>
</page>
<page arvcontinue="20101206223208|51">
  <title>Talk:Plugin API</title>
  <ns>1</ns>
  <id>9</id>
  <revision>
    <id>79</id>
    <timestamp>2011-01-05T01:04:44Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>Created page with "&lt;code&gt;sendBlock()&lt;/code&gt; ~~~~"</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="79" xml:space="preserve">&lt;code&gt;sendBlock()&lt;/code&gt; [[User:Nathacof|Nathacof]] 03:04, 5 January 2011 (EET)</text>
    <sha1>a6eb41c93e0de5cb2f106c36587a46d6543cf225</sha1>
  </revision>
  <revision>
    <id>81</id>
    <parentid>79</parentid>
    <timestamp>2011-01-05T07:36:36Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="280" xml:space="preserve">=A few Questions=
* There's no &lt;code&gt;sendBlock()&lt;/code&gt; in the plugin_api.h file?
* Why is &lt;code&gt;dtos()&lt;/code&gt; defined in command.cpp but referenced in the example plugin?
* How do I get a callback function to accept a User object if I do not include the class files in my plugin?</text>
    <sha1>c6f4a79fd952bfae40fa74ad82369980d43f9fa2</sha1>
  </revision>
  <revision>
    <id>82</id>
    <parentid>81</parentid>
    <timestamp>2011-01-05T07:59:25Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>/* A few Questions */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="361" xml:space="preserve">=A few Questions=
* There's no &lt;code&gt;sendBlock()&lt;/code&gt; in the plugin_api.h file? [[User:Nathacof|Nathacof]]
* Why is &lt;code&gt;dtos()&lt;/code&gt; defined in command.cpp but referenced in the example plugin? [[User:Nathacof|Nathacof]]
* How do I get a callback function to accept a User object if I do not include the class files in my plugin? [[User:Nathacof|Nathacof]]</text>
    <sha1>050b2849153047314896a63b92f79f9f982fd8a8</sha1>
  </revision>
  <revision>
    <id>88</id>
    <parentid>82</parentid>
    <timestamp>2011-01-07T22:14:43Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <minor/>
    <comment>/* A few Questions */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="639" xml:space="preserve">=A few Questions=
* There's no &lt;code&gt;sendBlock()&lt;/code&gt; in the plugin_api.h file? [[User:Nathacof|Nathacof]]
It's done automatically on setBlock() --[[User:Fador|Fador]] 00:14, 8 January 2011 (EET)
* Why is &lt;code&gt;dtos()&lt;/code&gt; defined in command.cpp but referenced in the example plugin? [[User:Nathacof|Nathacof]]
Now it's in the example --[[User:Fador|Fador]] 00:14, 8 January 2011 (EET)
* How do I get a callback function to accept a User object if I do not include the class files in my plugin? [[User:Nathacof|Nathacof]]
Users are referenced by the name (char *), no objects are used --[[User:Fador|Fador]] 00:14, 8 January 2011 (EET)</text>
    <sha1>e8eb25f3a2c51f3435c8d5bdadb70a45c9868c5a</sha1>
  </revision>
</page>
<page arvcontinue="20101206223208|51">
  <title>User:Nathacof</title>
  <ns>2</ns>
  <id>10</id>
  <revision>
    <id>80</id>
    <timestamp>2011-01-05T01:46:56Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>Created page with "Oh hai there!"</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="13" xml:space="preserve">Oh hai there!</text>
    <sha1>a61bf195f3f0055efd7bd5758a1fc3b8212028ee</sha1>
  </revision>
</page>
<page arvcontinue="20101206223208|51">
  <title>Frequently Asked Questions</title>
  <ns>0</ns>
  <id>4</id>
  <revision>
    <id>94</id>
    <parentid>41</parentid>
    <timestamp>2011-01-13T22:09:45Z</timestamp>
    <contributor>
      <username>Liamallan</username>
      <id>14</id>
    </contributor>
    <comment>Added more questions for you</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="631" xml:space="preserve">; Isn't it illegal to copy Notch's code?!
: We have created this software without decompiling the original codes. It's also a bit different in some ways. We only use the same protocol.

; What ipnaddress do we have to use
: You have to use your modem or ipv4 ip address, goto cmd and type "ipconfig" to find out your ivp4 ip address

; can we use Hamachi
: yes you can use hamachi, The ip you need for the configuration is your hamachi ip address

; is there a built in GUI
: no not at this time. It's a command based program, simple and easy to use

; can you run thisnon WinXP
: no you cannot, minecraft is not comparable with XP</text>
    <sha1>f77d68c4083c24c49116dddcf16be257facf6791</sha1>
  </revision>
  <revision>
    <id>95</id>
    <parentid>94</parentid>
    <timestamp>2011-01-13T22:10:12Z</timestamp>
    <contributor>
      <username>Liamallan</username>
      <id>14</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="631" xml:space="preserve">; Isn't it illegal to copy Notch's code?!
: We have created this software without decompiling the original codes. It's also a bit different in some ways. We only use the same protocol.

; What ip address do we have to use
: You have to use your modem or ipv4 ip address, goto cmd and type "ipconfig" to find out your ivp4 ip address

; can we use Hamachi
: yes you can use hamachi, The ip you need for the configuration is your hamachi ip address

; is there a built in GUI
: no not at this time. It's a command based program, simple and easy to use

; can you run thisnon WinXP
: no you cannot, minecraft is not comparable with XP</text>
    <sha1>be9b249e111b7a45804d59af4625c0627abfe8b6</sha1>
  </revision>
  <revision>
    <id>97</id>
    <parentid>95</parentid>
    <timestamp>2011-01-13T22:14:32Z</timestamp>
    <contributor>
      <username>Liamallan</username>
      <id>14</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="690" xml:space="preserve">; Isn't it illegal to copy Notch's code?!
: We have created this software without decompiling the original codes. It's also a bit different in some ways. We only use the same protocol.

; What ip address do we have to use
: You have to use your modem or ipv4 ip address, goto cmd and type "ipconfig" to find out your ivp4 ip address

; can we use Hamachi
: yes you can use hamachi, The ip you need for the configuration is your hamachi ip address

; is there a built in GUI
: no not at this time. It's a command based program, simple and easy to use

; can you run thisnon WinXP
: no you cannot, minecraft is not comparable with XP

; where can I get my ip address from
: goto www.cmyip.com</text>
    <sha1>48ca9f148b39d843386d0cdae4c50beabbecca80</sha1>
  </revision>
</page>
<page arvcontinue="20101206223208|51">
  <title>Help:Contents</title>
  <ns>12</ns>
  <id>11</id>
  <revision>
    <id>98</id>
    <timestamp>2011-01-13T22:17:09Z</timestamp>
    <contributor>
      <username>Liamallan</username>
      <id>14</id>
    </contributor>
    <comment>Created page with "I am a user that uses mineserver as my server  If you need any help at all, email me Metroid-Liam@hotmail.co.uk  Thanks mineserver you rock my socks of"</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="151" xml:space="preserve">I am a user that uses mineserver as my server

If you need any help at all, email me
Metroid-Liam@hotmail.co.uk

Thanks mineserver you rock my socks of</text>
    <sha1>e92e27cbad9ad303fc07ff61aec47ef22f493013</sha1>
  </revision>
</page>
<page arvcontinue="20101206223208|51">
  <title>User:Liamallan</title>
  <ns>2</ns>
  <id>12</id>
  <revision>
    <id>99</id>
    <timestamp>2011-01-13T22:23:35Z</timestamp>
    <contributor>
      <username>Liamallan</username>
      <id>14</id>
    </contributor>
    <comment>Created page with "A full time minecraft player, with his own mineserver server If you want you can add me on Skype "liamallan12345" is my username And if you need any help at all send me a email M..."</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="211" xml:space="preserve">A full time minecraft player, with his own mineserver server
If you want you can add me on Skype "liamallan12345" is my username
And if you need any help at all send me a email
Metroid-Liam@hotmail.co.uk

Thanks</text>
    <sha1>58e2728b11173f8ae402985262429088541c13dc</sha1>
  </revision>
</page>
<page arvcontinue="20110116000803|101">
  <title>Plugin API</title>
  <ns>0</ns>
  <id>8</id>
  <revision>
    <id>101</id>
    <parentid>100</parentid>
    <timestamp>2011-01-16T00:08:03Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <comment>/* Available callbacks */ PlayerChatCommand</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="13446" xml:space="preserve">Mineserver uses a C-plugin API which is described in this page.

==Creating a plugin==

You will need to include &lt;code&gt;plugin_api.h&lt;/code&gt; to your project.

...write some more stuff here...

Example plugin structure:

&lt;code&gt;
  #include "plugin_api.h"
  #define PLUGIN_VERSION 1.0
  std::string dtos( double n )
  {
    std::ostringstream result;
    result &lt;&lt; n;
    return result.str();
  }
  mineserver_pointer_struct* mineserver;
  std::string pluginName = "command";
  PLUGIN_API_EXPORT void (plugin_name)_init(mineserver_pointer_struct* mineserver_temp)
  {
    mineserver = mineserver_temp;
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()) &gt; 0)
    {
      std::string msg="command is already loaded v." +dtos(mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()));
      mineserver-&gt;screen.log(msg.c_str(),msg.size());
      return;
    }
    std::string msg="Loaded "+pluginName+"!";
    mineserver-&gt;screen.log(msg.c_str());
    mineserver-&gt;plugin.setPluginVersion(pluginName.c_str(), PLUGIN_COMMAND_VERSION);
    mineserver-&gt;plugin.addCallback("PlayerChatPre", (void *)SOMEFUNCTIONNAME);
    mineserver-&gt;plugin.addCallback("BlockPlacePre", (void *)SOMEFUNCTIONNAME2);
  }
  PLUGIN_API_EXPORT void (plugin_name)_shutdown(void)
  {
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()) &lt;= 0)
    {
      mineserver-&gt;screen.log("command is not loaded!"));
      return;
    }
  }
&lt;/code&gt;

==Available functions==


===Mineserver===

====Chat====


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="2" | '''sendmsgTo'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, telling it the user was found
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''sendmsg'''
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, telling it the user was found
|}

====Screen====

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''log'''
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row3"
| class="col0" colspan="4" | Prints message to server window
|}

====Map====


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''createPickupSpawn'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | count
| class="col2" | int
| class="col3" | How many to spawn (1-64)
|- class="row4"
| class="col1" | health
| class="col2" | int
| class="col3" | item health (0 = full health, max value depends on the item)
|- class="row5"
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row7"
| class="col0" colspan="4" | Spawns an item at (x,y,z) with type,count and health specified. If "user" is set, he will not be able to pick up the item right away to make it possible to throw stuff away.
|}


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''setTime'''
| class="col1" | timeValue
| class="col2" | int
| class="col3" | value 0-24000
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row3"
| class="col0" colspan="4" | Sets server time to timeValue, which can be in range 0-24000
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''getSpawn'''
| class="col1" | x
| class="col2" | int*
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int*
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int*
| class="col3" | z-coordinate
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row5"
| class="col0" colspan="4" | Gets server spawn position
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''getBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Get block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''setBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Set block type and metadata (absolute block coordinates)
|}

==Available callbacks==


{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer200'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 200ms timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer1000'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 1000ms (1s) timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer10000'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 10s timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''PlayerChatPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | timestamp
| class="col2" | size_t
| class="col3" | time of the message
|- class="row2"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row4"
| class="col0" colspan="4" | called on chat message processing, returning false will terminate the callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''PlayerChatCommand'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | command
| class="col2" | const char*
| class="col3" | command
|- class="row2"
| class="col1" | argc
| class="col2" | int
| class="col3" | argument count
|- class="row3"
| class="col1" | arguments
| class="col2" | const char**
| class="col3" | list of arguments
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row5"
| class="col0" colspan="4" | called when chat command is used
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''BlockPlacePre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int32_t
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int8_t
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int32_t
| class="col3" | z-coord
|- class="row5"
| class="col1" | block
| class="col2" | int16_t
| class="col3" | block type
|- class="row6"
| class="col1" | direction
| class="col2" | int8_t
| class="col3" | placement direction
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row8"
| class="col0" colspan="4" | called on block placement, returning false will prevent block placement and terminate callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''BlockBreakPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coord
|- class="row5"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row6"
| class="col0" colspan="4" | called on block break, returning false will prevent block breaking and terminate callback.
|}


ToDo:

    setHook("PlayerLoginPre", new Hook2&lt;bool,const char*,char***&gt;);
    setHook("PlayerLoginPost", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerNickPost", new Hook2&lt;bool,const char*,const char*&gt;);
    setHook("PlayerKickPost", new Hook2&lt;bool,const char*,const char*&gt;);
    setHook("PlayerQuitPost", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerChatPost", new Hook3&lt;bool,const char*,time_t,const char*&gt;);
    setHook("PlayerArmSwing", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerDamagePre", new Hook3&lt;bool,const char*,const char*,int&gt;);
    setHook("PlayerDamagePost", new Hook3&lt;bool,const char*,const char*,int&gt;);
    setHook("PlayerDisconnect", new Hook3&lt;bool,const char*,uint32,uint16&gt;);
    setHook("PlayerDiggingStarted", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("PlayerDigging", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("PlayerDiggingStopped", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockBreakPre", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockBreakPost", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockNeighbourBreak", new Hook7&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32&gt;);
    setHook("BlockPlacePre", new Hook5&lt;bool,const char*,sint32,sint8,sint32,sint16&gt;);
    setHook("BlockPlacePost", new Hook5&lt;bool,const char*,sint32,sint8,sint32,sint16&gt;);
    setHook("BlockNeighbourPlace", new Hook7&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32&gt;);
    setHook("BlockReplacePost", new Hook6&lt;bool,const char*,sint32,sint8,sint32,sint16,sint16&gt;);
    setHook("BlockNeighbourReplace", new Hook9&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32,sint16,sint16&gt;);</text>
    <sha1>71fac8a2f08e1be2160e647e76f47b38ba649cb3</sha1>
  </revision>
  <revision>
    <id>129</id>
    <parentid>101</parentid>
    <timestamp>2011-02-26T18:28:01Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="15121" xml:space="preserve">Mineserver uses a C-plugin API which is described in this page.

==Creating a plugin==

You will need to include &lt;code&gt;plugin_api.h&lt;/code&gt; to your project.

...write some more stuff here...

Example plugin structure:

&lt;code&gt;
  #include "plugin_api.h"
  #define PLUGIN_VERSION 1.0
  std::string dtos( double n )
  {
    std::ostringstream result;
    result &lt;&lt; n;
    return result.str();
  }
  mineserver_pointer_struct* mineserver;
  std::string pluginName = "command";
  PLUGIN_API_EXPORT void (plugin_name)_init(mineserver_pointer_struct* mineserver_temp)
  {
    mineserver = mineserver_temp;
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()) &gt; 0)
    {
      std::string msg="command is already loaded v." +dtos(mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()));
      mineserver-&gt;screen.log(msg.c_str(),msg.size());
      return;
    }
    std::string msg="Loaded "+pluginName+"!";
    mineserver-&gt;screen.log(msg.c_str());
    mineserver-&gt;plugin.setPluginVersion(pluginName.c_str(), PLUGIN_COMMAND_VERSION);
    mineserver-&gt;plugin.addCallback("PlayerChatPre", (void *)SOMEFUNCTIONNAME);
    mineserver-&gt;plugin.addCallback("BlockPlacePre", (void *)SOMEFUNCTIONNAME2);
  }
  PLUGIN_API_EXPORT void (plugin_name)_shutdown(void)
  {
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()) &lt;= 0)
    {
      mineserver-&gt;screen.log("command is not loaded!"));
      return;
    }
  }
&lt;/code&gt;

==Available functions==


===Mineserver===

====Chat====

{{APIFunct2|sendmsgTo|user|const char*|Username in null Terminated char array|msg|const char*|Message in null terminated char array|bool, telling it the user was found|Sends a message to specified ''user''}}

{{APIFunct1|sendmsg|msg|const char*|Message in null terminated char array|bool, telling it the user was found|Sends a message to all players, except they are in DND mode}}

{{APIFunct1|sendUserList|user|const char*|User in null terminated char array|bool, telling it the user was found|Sends the playerlist to ''user''}}

====Screen====

{{APIFunctVoid|log|msg|const char*|Message in null terminated char array|Prints message to server window}}

====Map====


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''createPickupSpawn'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | count
| class="col2" | int
| class="col3" | How many to spawn (1-64)
|- class="row4"
| class="col1" | health
| class="col2" | int
| class="col3" | item health (0 = full health, max value depends on the item)
|- class="row5"
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row7"
| class="col0" colspan="4" | Spawns an item at (x,y,z) with type,count and health specified. If "user" is set, he will not be able to pick up the item right away to make it possible to throw stuff away.
|}


{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''setTime'''
| class="col1" | timeValue
| class="col2" | int
| class="col3" | value 0-24000
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row3"
| class="col0" colspan="4" | Sets server time to timeValue, which can be in range 0-24000
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''getSpawn'''
| class="col1" | x
| class="col2" | int*
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int*
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int*
| class="col3" | z-coordinate
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row5"
| class="col0" colspan="4" | Gets server spawn position
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''getBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Get block type and metadata (absolute block coordinates) in first world (id 0)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''getBlockW'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | w
| class="col2" | int
| class="col3" | World ID
|- class="row5"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row6"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row8"
| class="col0" colspan="4" | Gets block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''setBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Set block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''setBlockW'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | w
| class="col2" | int
| class="col3" | World ID
|- class="row5"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row6"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row8"
| class="col0" colspan="4" | Sets block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''setSpawn'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row5"
| class="col0" colspan="4" | Set spawn to x, y, z (absolute coordinates)
|}

==Available callbacks==


{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer200'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 200ms timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer1000'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 1000ms (1s) timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer10000'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 10s timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''PlayerChatPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | timestamp
| class="col2" | size_t
| class="col3" | time of the message
|- class="row2"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row4"
| class="col0" colspan="4" | called on chat message processing, returning false will terminate the callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''PlayerChatCommand'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | command
| class="col2" | const char*
| class="col3" | command
|- class="row2"
| class="col1" | argc
| class="col2" | int
| class="col3" | argument count
|- class="row3"
| class="col1" | arguments
| class="col2" | const char**
| class="col3" | list of arguments
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row5"
| class="col0" colspan="4" | called when chat command is used
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''BlockPlacePre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int32_t
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int8_t
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int32_t
| class="col3" | z-coord
|- class="row5"
| class="col1" | block
| class="col2" | int16_t
| class="col3" | block type
|- class="row6"
| class="col1" | direction
| class="col2" | int8_t
| class="col3" | placement direction
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row8"
| class="col0" colspan="4" | called on block placement, returning false will prevent block placement and terminate callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''BlockBreakPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coord
|- class="row5"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row6"
| class="col0" colspan="4" | called on block break, returning false will prevent block breaking and terminate callback.
|}


ToDo:

    setHook("PlayerLoginPre", new Hook2&lt;bool,const char*,char***&gt;);
    setHook("PlayerLoginPost", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerNickPost", new Hook2&lt;bool,const char*,const char*&gt;);
    setHook("PlayerKickPost", new Hook2&lt;bool,const char*,const char*&gt;);
    setHook("PlayerQuitPost", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerChatPost", new Hook3&lt;bool,const char*,time_t,const char*&gt;);
    setHook("PlayerArmSwing", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerDamagePre", new Hook3&lt;bool,const char*,const char*,int&gt;);
    setHook("PlayerDamagePost", new Hook3&lt;bool,const char*,const char*,int&gt;);
    setHook("PlayerDisconnect", new Hook3&lt;bool,const char*,uint32,uint16&gt;);
    setHook("PlayerDiggingStarted", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("PlayerDigging", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("PlayerDiggingStopped", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockBreakPre", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockBreakPost", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockNeighbourBreak", new Hook7&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32&gt;);
    setHook("BlockPlacePre", new Hook5&lt;bool,const char*,sint32,sint8,sint32,sint16&gt;);
    setHook("BlockPlacePost", new Hook5&lt;bool,const char*,sint32,sint8,sint32,sint16&gt;);
    setHook("BlockNeighbourPlace", new Hook7&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32&gt;);
    setHook("BlockReplacePost", new Hook6&lt;bool,const char*,sint32,sint8,sint32,sint16,sint16&gt;);
    setHook("BlockNeighbourReplace", new Hook9&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32,sint16,sint16&gt;);</text>
    <sha1>f5d218476bd15208b3d7d598c21031d7e62037ec</sha1>
  </revision>
  <revision>
    <id>131</id>
    <parentid>129</parentid>
    <timestamp>2011-02-26T18:39:34Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="14002" xml:space="preserve">Mineserver uses a C-plugin API which is described in this page.

==Creating a plugin==

You will need to include &lt;code&gt;plugin_api.h&lt;/code&gt; to your project.

...write some more stuff here...

Example plugin structure:

&lt;code&gt;
  #include "plugin_api.h"
  #define PLUGIN_VERSION 1.0
  std::string dtos( double n )
  {
    std::ostringstream result;
    result &lt;&lt; n;
    return result.str();
  }
  mineserver_pointer_struct* mineserver;
  std::string pluginName = "command";
  PLUGIN_API_EXPORT void (plugin_name)_init(mineserver_pointer_struct* mineserver_temp)
  {
    mineserver = mineserver_temp;
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()) &gt; 0)
    {
      std::string msg="command is already loaded v." +dtos(mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()));
      mineserver-&gt;screen.log(msg.c_str(),msg.size());
      return;
    }
    std::string msg="Loaded "+pluginName+"!";
    mineserver-&gt;screen.log(msg.c_str());
    mineserver-&gt;plugin.setPluginVersion(pluginName.c_str(), PLUGIN_COMMAND_VERSION);
    mineserver-&gt;plugin.addCallback("PlayerChatPre", (void *)SOMEFUNCTIONNAME);
    mineserver-&gt;plugin.addCallback("BlockPlacePre", (void *)SOMEFUNCTIONNAME2);
  }
  PLUGIN_API_EXPORT void (plugin_name)_shutdown(void)
  {
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()) &lt;= 0)
    {
      mineserver-&gt;screen.log("command is not loaded!"));
      return;
    }
  }
&lt;/code&gt;

==Available functions==

===Mineserver===

====Chat====

{{APIFunct2|sendmsgTo|user|const char*|Username in null Terminated char array|msg|const char*|Message in null terminated char array|bool, telling it the user was found|Sends a message to specified ''user''}}

{{APIFunct1|sendmsg|msg|const char*|Message in null terminated char array|bool, telling it the user was found|Sends a message to all players, except they are in DND mode}}

{{APIFunct1|sendUserList|user|const char*|User in null terminated char array|bool, telling it the user was found|Sends the playerlist to ''user''}}

====Screen====

{{APIFunctVoid|log|msg|const char*|Message in null terminated char array|Prints message to server window}}

====Map====

{{APIFunct6|createPickupSpawn|x|int|x-coordinate|y|int|y-coordinate|z|int|z-coordinate|conut|int|How many to spawn(1-64)|health|int|item health. 0 is max health, max value depends on the item|user|const char*|Username|void|Spawns an item at (x,y,z) with type,count and health specified. If "user" is set, he will not be able to pick up the item right away to make it possible to throw stuff away.}}

{{APIFunct1|setTime|timeValue|int|value between 0 and 2400|bool|Sets server time to ''timeValue''}}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''getSpawn'''
| class="col1" | x
| class="col2" | int*
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int*
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int*
| class="col3" | z-coordinate
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row5"
| class="col0" colspan="4" | Gets server spawn position
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''getBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Get block type and metadata (absolute block coordinates) in first world (id 0)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''getBlockW'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | w
| class="col2" | int
| class="col3" | World ID
|- class="row5"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row6"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row8"
| class="col0" colspan="4" | Gets block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''setBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Set block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''setBlockW'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | w
| class="col2" | int
| class="col3" | World ID
|- class="row5"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row6"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row8"
| class="col0" colspan="4" | Sets block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''setSpawn'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row5"
| class="col0" colspan="4" | Set spawn to x, y, z (absolute coordinates)
|}

==Available callbacks==


{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer200'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 200ms timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer1000'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 1000ms (1s) timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer10000'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 10s timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''PlayerChatPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | timestamp
| class="col2" | size_t
| class="col3" | time of the message
|- class="row2"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row4"
| class="col0" colspan="4" | called on chat message processing, returning false will terminate the callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''PlayerChatCommand'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | command
| class="col2" | const char*
| class="col3" | command
|- class="row2"
| class="col1" | argc
| class="col2" | int
| class="col3" | argument count
|- class="row3"
| class="col1" | arguments
| class="col2" | const char**
| class="col3" | list of arguments
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row5"
| class="col0" colspan="4" | called when chat command is used
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''BlockPlacePre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int32_t
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int8_t
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int32_t
| class="col3" | z-coord
|- class="row5"
| class="col1" | block
| class="col2" | int16_t
| class="col3" | block type
|- class="row6"
| class="col1" | direction
| class="col2" | int8_t
| class="col3" | placement direction
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row8"
| class="col0" colspan="4" | called on block placement, returning false will prevent block placement and terminate callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''BlockBreakPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coord
|- class="row5"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row6"
| class="col0" colspan="4" | called on block break, returning false will prevent block breaking and terminate callback.
|}


ToDo:

    setHook("PlayerLoginPre", new Hook2&lt;bool,const char*,char***&gt;);
    setHook("PlayerLoginPost", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerNickPost", new Hook2&lt;bool,const char*,const char*&gt;);
    setHook("PlayerKickPost", new Hook2&lt;bool,const char*,const char*&gt;);
    setHook("PlayerQuitPost", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerChatPost", new Hook3&lt;bool,const char*,time_t,const char*&gt;);
    setHook("PlayerArmSwing", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerDamagePre", new Hook3&lt;bool,const char*,const char*,int&gt;);
    setHook("PlayerDamagePost", new Hook3&lt;bool,const char*,const char*,int&gt;);
    setHook("PlayerDisconnect", new Hook3&lt;bool,const char*,uint32,uint16&gt;);
    setHook("PlayerDiggingStarted", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("PlayerDigging", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("PlayerDiggingStopped", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockBreakPre", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockBreakPost", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockNeighbourBreak", new Hook7&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32&gt;);
    setHook("BlockPlacePre", new Hook5&lt;bool,const char*,sint32,sint8,sint32,sint16&gt;);
    setHook("BlockPlacePost", new Hook5&lt;bool,const char*,sint32,sint8,sint32,sint16&gt;);
    setHook("BlockNeighbourPlace", new Hook7&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32&gt;);
    setHook("BlockReplacePost", new Hook6&lt;bool,const char*,sint32,sint8,sint32,sint16,sint16&gt;);
    setHook("BlockNeighbourReplace", new Hook9&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32,sint16,sint16&gt;);</text>
    <sha1>3cf88721e8665c8f817914cefbcc59d37a5d0a54</sha1>
  </revision>
  <revision>
    <id>137</id>
    <parentid>131</parentid>
    <timestamp>2011-02-26T20:21:17Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="15277" xml:space="preserve">Mineserver uses a C-plugin API which is described in this page.

==Creating a plugin==

You will need to include &lt;code&gt;plugin_api.h&lt;/code&gt; to your project.

...write some more stuff here...

Example plugin structure:

&lt;code&gt;
  #include "plugin_api.h"
  #define PLUGIN_VERSION 1.0
  std::string dtos( double n )
  {
    std::ostringstream result;
    result &lt;&lt; n;
    return result.str();
  }
  mineserver_pointer_struct* mineserver;
  std::string pluginName = "command";
  PLUGIN_API_EXPORT void (plugin_name)_init(mineserver_pointer_struct* mineserver_temp)
  {
    mineserver = mineserver_temp;
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()) &gt; 0)
    {
      std::string msg="command is already loaded v." +dtos(mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()));
      mineserver-&gt;screen.log(msg.c_str(),msg.size());
      return;
    }
    std::string msg="Loaded "+pluginName+"!";
    mineserver-&gt;screen.log(msg.c_str());
    mineserver-&gt;plugin.setPluginVersion(pluginName.c_str(), PLUGIN_COMMAND_VERSION);
    mineserver-&gt;plugin.addCallback("PlayerChatPre", (void *)SOMEFUNCTIONNAME);
    mineserver-&gt;plugin.addCallback("BlockPlacePre", (void *)SOMEFUNCTIONNAME2);
  }
  PLUGIN_API_EXPORT void (plugin_name)_shutdown(void)
  {
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()) &lt;= 0)
    {
      mineserver-&gt;screen.log("command is not loaded!"));
      return;
    }
  }
&lt;/code&gt;

==Available functions==

===Mineserver===

====Chat====

{{APIFunct2|sendmsgTo|user|const char*|Username in null Terminated char array|msg|const char*|Message in null terminated char array|bool, telling it the user was found|Sends a message to specified ''user''}}

{{APIFunct1|sendmsg|msg|const char*|Message in null terminated char array|bool, telling it the user was found|Sends a message to all players, except they are in DND mode}}

{{APIFunct1|sendUserList|user|const char*|User in null terminated char array|bool, telling it the user was found|Sends the playerlist to ''user''}}

====Screen====

{{APIFunctVoid|log|msg|const char*|Message in null terminated char array|Prints message to server window}}

====Map====

{{APIFunct6|createPickupSpawn|x|int|x-coordinate|y|int|y-coordinate|z|int|z-coordinate|conut|int|How many to spawn(1-64)|health|int|item health. 0 is max health, max value depends on the item|user|const char*|Username|void|Spawns an item at (x,y,z) with type,count and health specified. If "user" is set, he will not be able to pick up the item right away to make it possible to throw stuff away.}}

{{APIFunct1|setTime|timeValue|int|value between 0 and 2400|bool|Sets server time to ''timeValue''}}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''getSpawn'''
| class="col1" | x
| class="col2" | int*
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int*
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int*
| class="col3" | z-coordinate
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row5"
| class="col0" colspan="4" | Gets server spawn position
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''getBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Get block type and metadata (absolute block coordinates) in first world (id 0)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''getBlockW'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | w
| class="col2" | int
| class="col3" | World ID
|- class="row5"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row6"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row8"
| class="col0" colspan="4" | Gets block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''setBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Set block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''setBlockW'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | w
| class="col2" | int
| class="col3" | World ID
|- class="row5"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row6"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row8"
| class="col0" colspan="4" | Sets block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''setSpawn'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row5"
| class="col0" colspan="4" | Set spawn to x, y, z (absolute coordinates)
|}

{{APIFunctVoid|saveWholeMap| |void| |Saves the whole map to disk}}

{{APIFunct2|getMapData_block|x|int|x-coordinate|z|int|z-coordinate|unsigned char*| }}

{{APIFunct2|getMapData_meta|x|int|x-coordinate|z|int|z-coordinate|unsigned char*| }}

{{APIFunct2|getMapData_skylight|x|int|x-coordinate|z|int|z-coordinate|unsigned char*| }}

{{APIFunct2|getMapData_blocklight|x|int|x-coordinate|z|int|z-coordinate|unsigned char*| }}

====User Functions====

{{APIFunct1|toggleDND|user|const char*|Username in null terminated char array|bool, indicates if user was found|Toggles the DND (Do not Disturb)-Mode of a ''user''}}

{{APIFunct7|getPosition|user|const char*|Username in null terminated char array|x|double*|x-coordinate|y|double*|y-coordinate|z|double*|z-coordinate|yaw|float*|yaw-Value|pitch|float*|pitch-Value|*stance|double|stance-Value|bool, true if user has been found|Finds a player and stores its info in the referenced variables}}

{{APIFunct8|getPosition|user|const char*|Username in null terminated char array|x|double*|x-coordinate|y|double*|y-coordinate|z|double*|z-coordinate|w|int*|World ID|yaw|float*|yaw-Value|pitch|float*|pitch-Value|*stance|double|stance-Value|bool, true if user has been found|Finds a player and stores its info in the referenced variables}}

==Available callbacks==

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer200'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 200ms timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer1000'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 1000ms (1s) timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer10000'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 10s timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''PlayerChatPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | timestamp
| class="col2" | size_t
| class="col3" | time of the message
|- class="row2"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row4"
| class="col0" colspan="4" | called on chat message processing, returning false will terminate the callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''PlayerChatCommand'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | command
| class="col2" | const char*
| class="col3" | command
|- class="row2"
| class="col1" | argc
| class="col2" | int
| class="col3" | argument count
|- class="row3"
| class="col1" | arguments
| class="col2" | const char**
| class="col3" | list of arguments
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row5"
| class="col0" colspan="4" | called when chat command is used
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''BlockPlacePre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int32_t
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int8_t
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int32_t
| class="col3" | z-coord
|- class="row5"
| class="col1" | block
| class="col2" | int16_t
| class="col3" | block type
|- class="row6"
| class="col1" | direction
| class="col2" | int8_t
| class="col3" | placement direction
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row8"
| class="col0" colspan="4" | called on block placement, returning false will prevent block placement and terminate callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''BlockBreakPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coord
|- class="row5"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row6"
| class="col0" colspan="4" | called on block break, returning false will prevent block breaking and terminate callback.
|}


ToDo:

    setHook("PlayerLoginPre", new Hook2&lt;bool,const char*,char***&gt;);
    setHook("PlayerLoginPost", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerNickPost", new Hook2&lt;bool,const char*,const char*&gt;);
    setHook("PlayerKickPost", new Hook2&lt;bool,const char*,const char*&gt;);
    setHook("PlayerQuitPost", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerChatPost", new Hook3&lt;bool,const char*,time_t,const char*&gt;);
    setHook("PlayerArmSwing", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerDamagePre", new Hook3&lt;bool,const char*,const char*,int&gt;);
    setHook("PlayerDamagePost", new Hook3&lt;bool,const char*,const char*,int&gt;);
    setHook("PlayerDisconnect", new Hook3&lt;bool,const char*,uint32,uint16&gt;);
    setHook("PlayerDiggingStarted", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("PlayerDigging", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("PlayerDiggingStopped", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockBreakPre", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockBreakPost", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockNeighbourBreak", new Hook7&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32&gt;);
    setHook("BlockPlacePre", new Hook5&lt;bool,const char*,sint32,sint8,sint32,sint16&gt;);
    setHook("BlockPlacePost", new Hook5&lt;bool,const char*,sint32,sint8,sint32,sint16&gt;);
    setHook("BlockNeighbourPlace", new Hook7&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32&gt;);
    setHook("BlockReplacePost", new Hook6&lt;bool,const char*,sint32,sint8,sint32,sint16,sint16&gt;);
    setHook("BlockNeighbourReplace", new Hook9&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32,sint16,sint16&gt;);</text>
    <sha1>5953c5532d7cca817c28da32a38a7181cadd44f1</sha1>
  </revision>
  <revision>
    <id>140</id>
    <parentid>137</parentid>
    <timestamp>2011-02-26T21:27:19Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="19863" xml:space="preserve">Mineserver uses a C-plugin API which is described in this page.

==Creating a plugin==

You will need to include &lt;code&gt;plugin_api.h&lt;/code&gt; to your project.

...write some more stuff here...

Example plugin structure:

&lt;code&gt;
  #include "plugin_api.h"
  #define PLUGIN_VERSION 1.0
  std::string dtos( double n )
  {
    std::ostringstream result;
    result &lt;&lt; n;
    return result.str();
  }
  mineserver_pointer_struct* mineserver;
  std::string pluginName = "command";
  PLUGIN_API_EXPORT void (plugin_name)_init(mineserver_pointer_struct* mineserver_temp)
  {
    mineserver = mineserver_temp;
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()) &gt; 0)
    {
      std::string msg="command is already loaded v." +dtos(mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()));
      mineserver-&gt;screen.log(msg.c_str(),msg.size());
      return;
    }
    std::string msg="Loaded "+pluginName+"!";
    mineserver-&gt;screen.log(msg.c_str());
    mineserver-&gt;plugin.setPluginVersion(pluginName.c_str(), PLUGIN_COMMAND_VERSION);
    mineserver-&gt;plugin.addCallback("PlayerChatPre", (void *)SOMEFUNCTIONNAME);
    mineserver-&gt;plugin.addCallback("BlockPlacePre", (void *)SOMEFUNCTIONNAME2);
  }
  PLUGIN_API_EXPORT void (plugin_name)_shutdown(void)
  {
    if (mineserver-&gt;plugin.getPluginVersion(pluginName.c_str()) &lt;= 0)
    {
      mineserver-&gt;screen.log("command is not loaded!"));
      return;
    }
  }
&lt;/code&gt;

==Available functions==

===Mineserver===

====Chat====

{{APIFunct2|sendmsgTo|user|const char*|Username in null Terminated char array|msg|const char*|Message in null terminated char array|bool, telling it the user was found|Sends a message to specified ''user''}}

{{APIFunct1|sendmsg|msg|const char*|Message in null terminated char array|bool, telling it the user was found|Sends a message to all players, except they are in DND mode}}

{{APIFunct1|sendUserList|user|const char*|User in null terminated char array|bool, telling it the user was found|Sends the playerlist to ''user''}}

====Screen====

{{APIFunctVoid|log|msg|const char*|Message in null terminated char array|Prints message to server window}}

====Map====

{{APIFunct6|createPickupSpawn|x|int|x-coordinate|y|int|y-coordinate|z|int|z-coordinate|conut|int|How many to spawn(1-64)|health|int|item health. 0 is max health, max value depends on the item|user|const char*|Username|void|Spawns an item at (x,y,z) with type,count and health specified. If "user" is set, he will not be able to pick up the item right away to make it possible to throw stuff away.}}

{{APIFunct1|setTime|timeValue|int|value between 0 and 2400|bool|Sets server time to ''timeValue''}}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''getSpawn'''
| class="col1" | x
| class="col2" | int*
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int*
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int*
| class="col3" | z-coordinate
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row5"
| class="col0" colspan="4" | Gets server spawn position
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''getBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Get block type and metadata (absolute block coordinates) in first world (id 0)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''getBlockW'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | w
| class="col2" | int
| class="col3" | World ID
|- class="row5"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row6"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row8"
| class="col0" colspan="4" | Gets block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''setBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Set block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''setBlockW'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | w
| class="col2" | int
| class="col3" | World ID
|- class="row5"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row6"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row8"
| class="col0" colspan="4" | Sets block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''setSpawn'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row5"
| class="col0" colspan="4" | Set spawn to x, y, z (absolute coordinates)
|}

{{APIFunctVoid|saveWholeMap| |void| |Saves the whole map to disk}}

{{APIFunct2|getMapData_block|x|int|x-coordinate|z|int|z-coordinate|unsigned char*| }}

{{APIFunct2|getMapData_meta|x|int|x-coordinate|z|int|z-coordinate|unsigned char*| }}

{{APIFunct2|getMapData_skylight|x|int|x-coordinate|z|int|z-coordinate|unsigned char*| }}

{{APIFunct2|getMapData_blocklight|x|int|x-coordinate|z|int|z-coordinate|unsigned char*| }}

====User Functions====

{{APIFunct1|toggleDND|user|const char*|Username in null terminated char array|bool, indicates if user was found|Toggles the DND (Do not Disturb)-Mode of a ''user''}}

{{APIFunct7|getPosition|user|const char*|Username in null terminated char array|x|double*|x-coordinate|y|double*|y-coordinate|z|double*|z-coordinate|yaw|float*|yaw-Value|pitch|float*|pitch-Value|*stance|double|stance-Value|bool, true if user has been found|Finds a player and stores its info in the referenced variables}}

{{APIFunct8|getPosition|user|const char*|Username in null terminated char array|x|double*|x-coordinate|y|double*|y-coordinate|z|double*|z-coordinate|w|int*|World ID|yaw|float*|yaw-Value|pitch|float*|pitch-Value| *stance|double|stance-Value|bool, true if user has been found|Finds a player and stores its info in the referenced variables}}

{{APIFunct4|teleport|user|const char*|Username in null terminated char array|x|double*|x-coordinate|y|double*|y-coordinate|z|double*|z-coordinate|bool, true if user was found|Teleports a ''user'' to ''x'',''y'',''z''}}

{{APIFunct5|teleport|user|const char*|Username in null terminated char array|x|double*|x-coordinate|y|double*|y-coordinate|z|double*|z-coordinate|map|int|Map ID|bool, true if user was found|Teleports a ''user'' to ''x'',''y'',''z'' on ''map''}}

{{APIFunct2|setHealth|user|const char*|Username in null terminated char array|userHealth|int|Health of ''user''. Must not be greater than 20.|bool, true if user is not null|Sets the health of a ''user''.}}

{{APIFunct1|getHealth|user|const char*|Username in null terminated char array|int, player's health|Gets the health of a ''user''}}

{{APIFunct1|no paramters| | |int, number of players online|Gets the number of players online}}

{{APIFunct4|getItemInHand|user|const char*|Username in null terminated char array|*type|int|Type of item|*meta|int|Health of item|*quant|int|quantity of item|bool, true if user was found|Gets the item in the hand of ''user''}}

{{APIFunct4|setItemInHand|user|const char*|Username in null terminated char array|type|int|Type of item|meta|int|Health of item|quant|int|quantity of item, must not be greater than 64|bool, true if user was found|Sets the item in the hand of ''user''}}

{{APIFunct4|addItem|user|const char*|Username in null terminated char array|type|int|Type of item|meta|int|Health of item|quant|int|quantity of item, must not be greater than 64|bool, true if user was found|Adds the ''item'' to the ''user'''s inventory}}

{{APIFunct4|hasItem|user|const char*|Username in null terminated char array|type|int|Type of item|meta|int|Health of item|quant|int|quantity of item, must not be greater than 64|bool, true if the item is in Users inventory. Chests are unchecked.|Checks if ''item'' is in ''user'''s inventory}}

{{APIFunct4|delItem|user|const char*|Username in null terminated char array|type|int|Type of item|meta|int|Health of item|quant|int|quantity of item, must not be greater than 64|bool, true if user was found|Delets the ''item'' ''quantity'' times from the ''user'''s inventory. Chests are untouched.}}

{{APIFunct1|kick|user|const char*|Username in null terminated char array|bool, true if user is found|Kicks ''user'' with standard reason "You have been kicked"}}

====Config wrapper functions====
{{APIFunct1|has|name|const char*|name of the config string|bool, true if config string was found|Checks if the config string ''name'' exists in the configuration file}}

{{APIFunct1|iData|name|const char*|name of the config string|int|Gets integer data from configuration string ''name''}}

{{APIFunct1|lData|name|const char*|name of the config string|int64_t|Gets long (int64_t) data from configuration string ''name''}}

{{APIFunct1|fData|name|const char*|name of the config string|float|Gets float data from configuration string ''name''}}

{{APIFunct1|dData|name|const char*|name of the config string|double|Gets double data from configuration string ''name''}}

{{APIFunct1|sData|name|const char*|name of the config string|const char*|Gets string (char*) data from configuration string ''name''}}

{{APIFunct1|bData|name|const char*|name of the config string|bool|Gets bool data from configuration string ''name''}}

====Mobs====

====Permissions====

{{APIFunct1|setAdmin|name|const char*|Username in null terminated char array|bool, true if user was found|Makes ''user'' to a server administrator, providing him with full permissions.}}

{{APIFunct1|setOp|name|const char*|Username in null terminated char array|bool, true if user was found|Makes ''user'' to a server Operator}}

{{APIFunct1|setMember|name|const char*|Username in null terminated char array|bool, true if user was found|Makes ''user'' to a regular member}}

{{APIFunct1|setGuest|name|const char*|Username in null terminated char array|bool, true if user was found|Makes ''user'' to a guest}}

{{APIFunct1|isAdmin|name|const char*|Username in null terminated char array|bool, true if user is admin|Checks, if ''user'' is a server administrator}}

{{APIFunct1|isOp|name|const char*|Username in null terminated char array|bool, true if user is operator|Checks, if ''user'' is a server Operator}}

{{APIFunct1|isMember|name|const char*|Username in null terminated char array|bool, true if user is member|Checks, if ''user'' is a regular member}}

{{APIFunct1|Guest|name|const char*|Username in null terminated char array|bool, true if user is guest|Checks, if ''user'' is a guest}}

==Available callbacks==

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer200'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 200ms timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer1000'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 1000ms (1s) timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer10000'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 10s timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''PlayerChatPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | timestamp
| class="col2" | size_t
| class="col3" | time of the message
|- class="row2"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row4"
| class="col0" colspan="4" | called on chat message processing, returning false will terminate the callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''PlayerChatCommand'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | command
| class="col2" | const char*
| class="col3" | command
|- class="row2"
| class="col1" | argc
| class="col2" | int
| class="col3" | argument count
|- class="row3"
| class="col1" | arguments
| class="col2" | const char**
| class="col3" | list of arguments
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row5"
| class="col0" colspan="4" | called when chat command is used
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''BlockPlacePre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int32_t
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int8_t
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int32_t
| class="col3" | z-coord
|- class="row5"
| class="col1" | block
| class="col2" | int16_t
| class="col3" | block type
|- class="row6"
| class="col1" | direction
| class="col2" | int8_t
| class="col3" | placement direction
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row8"
| class="col0" colspan="4" | called on block placement, returning false will prevent block placement and terminate callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''BlockBreakPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coord
|- class="row5"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row6"
| class="col0" colspan="4" | called on block break, returning false will prevent block breaking and terminate callback.
|}


ToDo:

    setHook("PlayerLoginPre", new Hook2&lt;bool,const char*,char***&gt;);
    setHook("PlayerLoginPost", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerNickPost", new Hook2&lt;bool,const char*,const char*&gt;);
    setHook("PlayerKickPost", new Hook2&lt;bool,const char*,const char*&gt;);
    setHook("PlayerQuitPost", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerChatPost", new Hook3&lt;bool,const char*,time_t,const char*&gt;);
    setHook("PlayerArmSwing", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerDamagePre", new Hook3&lt;bool,const char*,const char*,int&gt;);
    setHook("PlayerDamagePost", new Hook3&lt;bool,const char*,const char*,int&gt;);
    setHook("PlayerDisconnect", new Hook3&lt;bool,const char*,uint32,uint16&gt;);
    setHook("PlayerDiggingStarted", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("PlayerDigging", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("PlayerDiggingStopped", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockBreakPre", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockBreakPost", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockNeighbourBreak", new Hook7&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32&gt;);
    setHook("BlockPlacePre", new Hook5&lt;bool,const char*,sint32,sint8,sint32,sint16&gt;);
    setHook("BlockPlacePost", new Hook5&lt;bool,const char*,sint32,sint8,sint32,sint16&gt;);
    setHook("BlockNeighbourPlace", new Hook7&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32&gt;);
    setHook("BlockReplacePost", new Hook6&lt;bool,const char*,sint32,sint8,sint32,sint16,sint16&gt;);
    setHook("BlockNeighbourReplace", new Hook9&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32,sint16,sint16&gt;);</text>
    <sha1>6238eb8dc5d4ac91784dc5988b25610d1abddc85</sha1>
  </revision>
</page>
<page arvcontinue="20110116000803|101">
  <title>Coding Style</title>
  <ns>0</ns>
  <id>6</id>
  <revision>
    <id>102</id>
    <parentid>67</parentid>
    <timestamp>2011-01-16T12:15:14Z</timestamp>
    <contributor>
      <username>Deoxxa</username>
      <id>3</id>
    </contributor>
    <comment>changed the spacing information to what's actually used in the source</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2698" xml:space="preserve">This is a suggestion for a coding style to be used consistently accross Mineserver's source code.

* '''Indentation''': 2 spaces
* '''Class names''': Camelcase, starting with uppercase letter, e.g.: '''FurnaceManager'''
* '''Variable and method names''': Camelcase, starting with lowercase letter, e.g.: '''updateWorld()''', '''userCommands'''.
** '''Pointer variables''': Use '''Foo* bar''' instead of '''Foo *bar'''
** Using short names for loop variables is ok, e.g. '''i''', '''j'''. Otherwise use descriptive names and don't use abbreviations all over the place, to make the code more readable.
* '''Inline methods''': Keep them short (max 10-15 lines at most).
* '''Documentation''': Use doxygen-style (javadoc-style?) documentation for at least all public methods. Example:
    /**
     * The foo() method. Does some fooish stuff, yo!
     * @param bar Bar instance to be used in foo().
     * @return An instance of Baz that does something fantastic!
     */
     Baz* Foo::foo(Bar* bar);
** Note: Documentation should go in to the header file.
* '''Class definitions''': Put public methods at the top of the definition. They're usually the most interesting part from a user's point of view. Private stuff at the bottom.
    class Foo 
    {
      public:
      Foo();
      ~Foo();
    
      /**
       * The foo() method. Does some fooish stuff, yo!
       * @param bar Bar instance to be used in foo().
       * @return An instance of Baz that does something fantastic!
       */
      Baz* foo(Bar* bar);
      
      private:
      /* private instance vars etc go here.*/
    };
** '''Instance variables''' should usually be accessible through getter and setter methods and thus be private. In some cases having them public is fine (e.g. when they're accessed all over the place and modifiying them happens all over the place as well. Usually this is the case for "dumb classes" used as pure data structures. We should consider using a '''struct''' instead for these cases.). Also, don't use prefixes for public instance variables, since it's ugly to use. For private instance variables we could choose to use '''m_foo''' and have a getter method be just '''foo()''' and a setter '''setFoo()'''.
** '''Static (class) variables''' should start with just an underscore, e.g. '''_instance''', '''_users''' etc.
* '''Namespaces''': We probably should use them.
* '''Codeblocks''': Use braces always for clarity and to prevent bugs while editing code
    if (true)
    {
      foo = bar;
    }

    if (true)
    {
      foo = bar;
      foo2 = bar2;
    }
* '''Spacing''':
    Foo* bar = new Foo();
    fooBar(param1, param2, param3);
    for (int i = 0; i &lt; 1; i++)
    {
      ...
    }</text>
    <sha1>88075b7f1da274405ab6e683e89ee8f17255b916</sha1>
  </revision>
</page>
<page arvcontinue="20110116000803|101">
  <title>Frequently Asked Questions</title>
  <ns>0</ns>
  <id>4</id>
  <revision>
    <id>103</id>
    <parentid>97</parentid>
    <timestamp>2011-01-25T05:17:18Z</timestamp>
    <contributor>
      <username>Drewbug</username>
      <id>16</id>
    </contributor>
    <comment>Cleaned it up a bit</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="823" xml:space="preserve">; Isn't it illegal to copy Notch's code?!
: We have created this software without decompiling the original codes. It's also a bit different in some ways. We only use the same protocol.

; What IP address do I have to use?
: You have to use either your local or remote IP address. If you're on Windows, go to the command prompt (cmd) and type "ipconfig" to find out which IP address you should use.

; Can I use Hamachi?
: Yes, you can use Hamachi. The IP address you need to put in Mineserver's configuration file is your Hamachi IP address.

; Is there a built-in GUI?
: No, not at this time. It's a command-based program; simple and easy to use.

; Can you run this on Windows XP?
: No,you can not. Mineserver is not compatible with Windows XP.

; How can I find out what my remote IP address is?
: Go to [www.cmyip.com].</text>
    <sha1>1f014bd4204083606921b67bf23c4ad5d2d1f716</sha1>
  </revision>
  <revision>
    <id>104</id>
    <parentid>103</parentid>
    <timestamp>2011-01-25T05:17:51Z</timestamp>
    <contributor>
      <username>Drewbug</username>
      <id>16</id>
    </contributor>
    <minor/>
    <comment>forgot the http:// prefix for cmyip.com link</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="830" xml:space="preserve">; Isn't it illegal to copy Notch's code?!
: We have created this software without decompiling the original codes. It's also a bit different in some ways. We only use the same protocol.

; What IP address do I have to use?
: You have to use either your local or remote IP address. If you're on Windows, go to the command prompt (cmd) and type "ipconfig" to find out which IP address you should use.

; Can I use Hamachi?
: Yes, you can use Hamachi. The IP address you need to put in Mineserver's configuration file is your Hamachi IP address.

; Is there a built-in GUI?
: No, not at this time. It's a command-based program; simple and easy to use.

; Can you run this on Windows XP?
: No,you can not. Mineserver is not compatible with Windows XP.

; How can I find out what my remote IP address is?
: Go to [http://www.cmyip.com].</text>
    <sha1>aca0265cb2b802e4fcafd08203dbce586c7b007d</sha1>
  </revision>
  <revision>
    <id>105</id>
    <parentid>104</parentid>
    <timestamp>2011-01-25T05:38:01Z</timestamp>
    <contributor>
      <username>Drewbug</username>
      <id>16</id>
    </contributor>
    <minor/>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="831" xml:space="preserve">; Isn't it illegal to copy Notch's code?!
: We have created this software without decompiling the original codes. It's also a bit different in some ways. We only use the same protocol.

; What IP address do I have to use?
: You have to use either your local or remote IP address. If you're on Windows, go to the command prompt (cmd) and type "ipconfig" to find out which IP address you should use.

; Can I use Hamachi?
: Yes, you can use Hamachi. The IP address you need to put in Mineserver's configuration file is your Hamachi IP address.

; Is there a built-in GUI?
: No, not at this time. It's a command-based program; simple and easy to use.

; Can you run this on Windows XP?
: No, you can not. Mineserver is not compatible with Windows XP.

; How can I find out what my remote IP address is?
: Go to [http://www.cmyip.com].</text>
    <sha1>6f897ab2bf1d12b8c6e3c331f4e71decbc6b4c23</sha1>
  </revision>
  <revision>
    <id>108</id>
    <parentid>105</parentid>
    <timestamp>2011-01-25T18:24:40Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <minor/>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="774" xml:space="preserve">; Isn't it illegal to copy Notch's code?!
: We have created this software without decompiling the original codes. It's also a bit different in some ways. We only use the same protocol.

; What IP address do I have to use?
: You have to use either your local or remote IP address. If you're on Windows, go to the command prompt (cmd) and type "ipconfig" to find out which IP address you should use.

; Can I use Hamachi?
: Yes, you can use Hamachi. The IP address you need to put in Mineserver's configuration file is your Hamachi IP address.

; Is there a built-in GUI?
: No, not at this time. It's a command-based program; simple and easy to use.

; Can you run this on Windows XP?
: Sure.

; How can I find out what my remote IP address is?
: Go to [http://www.cmyip.com].</text>
    <sha1>3c16086e87dba281b28fae0975b7003a6b2c4813</sha1>
  </revision>
  <revision>
    <id>111</id>
    <parentid>108</parentid>
    <timestamp>2011-01-25T18:35:25Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="774" xml:space="preserve">; Isn't it illegal to copy Notch's code?!
: We have created this software without decompiling the original codes. It's also a bit different in some ways. We only use the same protocol.

; What IP address do I have to use?
: You have to use either your local or remote IP address. If you're on Windows, go to the command prompt (cmd) and type "ipconfig" to find out which IP address you should use.

; Can I use Hamachi?
: Yes, you can use Hamachi. The IP address you need to put in Mineserver's configuration file is your Hamachi IP address.

; Is there a built-in GUI?
: We have [[Plugins|plugin]] for NCurses gui but there won't be built-in GUI.

; Can you run this on Windows XP?
: Sure.

; How can I find out what my remote IP address is?
: Go to [http://www.cmyip.com].</text>
    <sha1>d3166ce29649d8e2140aeb6c97b2ff7a18d05552</sha1>
  </revision>
</page>
<page arvcontinue="20110116000803|101">
  <title>Main Page</title>
  <ns>0</ns>
  <id>1</id>
  <revision>
    <id>106</id>
    <parentid>75</parentid>
    <timestamp>2011-01-25T18:10:53Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="649" xml:space="preserve">Hi there! Welcome to the Mineserver wiki. Below is a list of articles that may or may not need writing. This page will be fleshed out when we have some more content here.

If you feel like creating, fixing and/or adding anything, you can log in with your forum account. If you don't yet have a forum account, you can create one [http://mineserver.be/forums/ here]. This wiki will become publicly editable when there are a few more users and we have some spam/vandal control in place.

* [[Installation]]
* [[Configuration]]
* [[Commands]]
* [[Frequently Asked Questions]]
* [[Advanced Usage]]
* [[Coding Style]]
* [[Plugin API]]

----

* [[Plugins]]</text>
    <sha1>541177d8197c0f5fc124d3baded1d7e053acdb6c</sha1>
  </revision>
</page>
<page arvcontinue="20110116000803|101">
  <title>Plugins</title>
  <ns>0</ns>
  <id>13</id>
  <revision>
    <id>107</id>
    <timestamp>2011-01-25T18:20:50Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <comment>Created page with "== Current plugins for Mineserver == Notice that plugins may have limited functionality and they are still being developed. * '''Commands''' - Add some commands to game (Included..."</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="704" xml:space="preserve">== Current plugins for Mineserver ==
Notice that plugins may have limited functionality and they are still being developed.
* '''Commands''' - Add some commands to game (Included)
* '''Ncurses ui''' - Nice ui for server (Included)
* '''Binlog''' - Log and rollback block changes(Included)
* '''nBreak''' - Notch-style block breaking(Included)
* '''Filelog''' - Log chat and stdout to files (Included)
* '''ircchat''' - Bridge between irc and minecraft chat (https://github.com/bluepeppers/mineserver/tree/master/plugins/ircchat)
* '''nether''' - needed for nether-normal world portals (Included)

'''Note:''' Those that are Included can be found at https://github.com/fador/mineserver/tree/master/plugins</text>
    <sha1>c0e83f936f2c243804377421ba55b0dd0deff691</sha1>
  </revision>
  <revision>
    <id>112</id>
    <parentid>107</parentid>
    <timestamp>2011-01-25T21:43:59Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>/* Current plugins for Mineserver */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="781" xml:space="preserve">== Current plugins for Mineserver ==
Notice that plugins may have limited functionality and they are still being developed.
;[[Plugin:Commands|Commands]]
:Add some commands to game (Included)
;[[Plugin:Ncursesui|Ncurses UI]]
:Nice ui for server (Included)
;[[Plugin:Binlog|Binlog]]
:Log and rollback block changes(Included)
;[[Plugin:nBreak|nBreak]]
:Notch-style block breaking(Included)
;[[Plugin:Filelog|Filelog]]
:Log chat and stdout to files (Included)
;[[Plugin:ircchat|Ircchat]]
:Bridge between irc and minecraft chat (https://github.com/bluepeppers/mineserver/tree/master/plugins/ircchat)
;[[Plugin:Nether|Nether]]
:needed for nether-normal world portals (Included)

'''Note:''' Those that are Included can be found at https://github.com/fador/mineserver/tree/master/plugins</text>
    <sha1>320d343064c74bdde33fba8252ffa1dd620fd757</sha1>
  </revision>
</page>
<page arvcontinue="20110116000803|101">
  <title>Configuration</title>
  <ns>0</ns>
  <id>2</id>
  <revision>
    <id>109</id>
    <parentid>62</parentid>
    <timestamp>2011-01-25T18:31:56Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <comment>Replaced content with "* Latest configuration file with explanations can be found here: https://github.com/fador/mineserver/blob/master/bin/config.cfg
* Configurable item aliases can be found here:..."</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="241" xml:space="preserve">* Latest configuration file with explanations can be found here: https://github.com/fador/mineserver/blob/master/bin/config.cfg
* Configurable item aliases can be found here: https://github.com/fador/mineserver/blob/master/bin/item_alias.cfg</text>
    <sha1>9e18072dcf687d5102ea37cc64df80a6165195d3</sha1>
  </revision>
</page>
<page arvcontinue="20110116000803|101">
  <title>Commands</title>
  <ns>0</ns>
  <id>5</id>
  <revision>
    <id>110</id>
    <parentid>44</parentid>
    <timestamp>2011-01-25T18:33:23Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <comment>Replaced content with "All commands are now being moved from core to commands plugin which can be found at [[Plugins]]"</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="95" xml:space="preserve">All commands are now being moved from core to commands plugin which can be found at [[Plugins]]</text>
    <sha1>f573a7ada375a2fc16c257997b88d17dcc63fe6b</sha1>
  </revision>
  <revision>
    <id>120</id>
    <parentid>110</parentid>
    <timestamp>2011-01-26T00:09:04Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>Redirected page to [[Plugin:Commands]]</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="124" xml:space="preserve">#REDIRECT[[Plugin:Commands]]
All commands are now being moved from core to commands plugin which can be found at [[Plugins]]</text>
    <sha1>775e675a7c2eec3a222470388288a79c6f0dc8ac</sha1>
  </revision>
  <revision>
    <id>149</id>
    <parentid>120</parentid>
    <timestamp>2011-02-26T22:36:37Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1679" xml:space="preserve">Parameters that are marked with &lt;&gt; (example: &lt;player&gt;) are required. Parameters marked with [] (example: [reason]) are optional. Usage example: "/kick johntheminer this is test kick"

== For all players ==
{| class="wikitable"
|-
! Command
! Description
|-
|/help [&lt;commandname&gt;]
|Displays help text showing all commands and their description, or, if &lt;commandname&gt; given, displays description text for that command.
|-
|/players, /who
|Lists online players
|-
|/about
|Server name &amp; version
|-
|/rules
|Show server rules
|-
|/home
|Teleports player to map spawn location
|-
|/motd
|Display Message Of The Day
|-
|/dnd
|Do Not Disturb - toggles whether the player receives chat &amp; private messages
|}

== Admin only ==
{| class="wikitable"
|-
! Command
! Description
|-
|/save
|Manually save map to disc
|-
|/ctp &lt;x&gt; &lt;y&gt; &lt;z&gt;
|Teleport to coordinates (eg. /ctp 100 100 100)
|-
|/tp &lt;player&gt;
|Teleport yourself to &lt;player&gt;'s position
|-
|/tp &lt;player1&gt; &lt;player2&gt;
|Teleport &lt;player1&gt; to &lt;player2&gt;
|-
|/give &lt;player&gt; &lt;id/alias&gt; [count]
|Gives &lt;player&gt; [count] pieces of &lt;id/alias&gt;. By default [count] = 1. Supports over 64 items. Aliases configurable in item_alias.cfg
|-
|/i &lt;id/alias&gt; [count]
|Gives self [count] pieces of &lt;id/alias&gt;. By default [count] = 1.
|-
|/rules &lt;player&gt;
|Shows server rules (from rules.txt) to &lt;player&gt;
|-
|/gps [player] 
|Without [player] shows own coordinates &amp; heading. With [player] shows [player]'s coordinates &amp; heading
|-
|/settime &lt;time&gt;
|Sets server time. &lt;time&gt; = 0-24000 (0 and 24000 is day and about 15000 is night)
|-
|/world &lt;worldnumber&gt;
|Teleport to another world defined in config.cfg. Worlds are in ALPHABETIC order.
|}

[[Category:Plugins]]</text>
    <sha1>804a6b66c6d1ba2aa29002e5bcf3b383f73b513b</sha1>
  </revision>
</page>
<page arvcontinue="20110116000803|101">
  <title>Plugin:Commands</title>
  <ns>0</ns>
  <id>14</id>
  <revision>
    <id>113</id>
    <timestamp>2011-01-25T21:44:25Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>Created page with "Parameters that are marked with &lt;&gt; (example: &lt;player&gt;) are required. Parameters marked with [] (example: [reason]) are optional. Usage example: "/kick johntheminer this is test k..."</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2244" xml:space="preserve">Parameters that are marked with &lt;&gt; (example: &lt;player&gt;) are required. Parameters marked with [] (example: [reason]) are optional. Usage example: "/kick johntheminer this is test kick"

== For all players ==
{| class="wikitable"
|-
! Command
! Description
|-
|/help [&lt;commandname&gt;]
|Displays help text showing all commands and their description, or, if &lt;commandname&gt; given, displays description text for that command.
|-
|/players, /who
|Lists online players
|-
|/about
|Server name &amp; version
|-
|/rules
|Show server rules
|-
|/home
|Teleports player to map spawn location
|-
|/kit &lt;name&gt;
|Gives kit. Items for kit defined in config.cfg with kit_&lt;name&gt; using item id's
|-
|/motd
|Display Message Of The Day
|-
|/dnd
|Do Not Disturb - toggles whether the player receives chat &amp; private messages
|-
|/emote, /em, /e, /me
|Emote
|-
|/whisper, /w, /tell, /t
|Send a private message to another player
|}

== Admin only ==
{| class="wikitable"
|-
! Command
! Description
|-
|%text
|Servermessage 
|-
|&amp;text
|Admin-only message
|-
|/kick &lt;player&gt; [reason]
|Kicks &lt;player&gt; with optional kick message
|-
|/ban &lt;player&gt; [reason]
|Bans (and kicks if online) &lt;player&gt; from server
|-
|/unban &lt;player&gt;
|Lift a ban
|-
|/save
|Manually save map to disc
|-
|/ctp &lt;x&gt; &lt;y&gt; &lt;z&gt;
|Teleport to coordinates (eg. /ctp 100 100 100)
|-
|/tp &lt;player&gt;
|Teleport yourself to &lt;player&gt;'s position
|-
|/tp &lt;player1&gt; &lt;player2&gt;
|Teleport &lt;player1&gt; to &lt;player2&gt;
|-
|/reload
|Reload admins and configuration
|-
|/give &lt;player&gt; &lt;id/alias&gt; [count]
|Gives &lt;player&gt; [count] pieces of &lt;id/alias&gt;. By default [count] = 1. Supports over 64 items. Aliases configurable in item_alias.cfg
|-
|/igive &lt;id/alias&gt; [count]
|Gives self [count] pieces of &lt;id/alias&gt;. By default [count] = 1.
|-
|/rules &lt;player&gt;
|Shows server rules (from rules.txt) to &lt;player&gt;
|-
|/gps [player] 
|Without [player] shows own coordinates &amp; heading. With [player] shows [player]'s coordinates &amp; heading
|-
|/settime &lt;time&gt;
|Sets server time. &lt;time&gt; = 0-24000 (0 and 24000 is day and about 15000 is night)
|-
|/mute &lt;player&gt; [reason]
|Mutes &lt;player&gt; with optional message
|-
|/unmute &lt;player&gt;
|Unmutes &lt;player&gt;
|-
|/regen
|Regenerates lightning
|-
|/sethealth &lt;player&gt; &lt;health&gt;
|Set &lt;player&gt;'s health. &lt;health&gt; = 0-20
|}</text>
    <sha1>d5e2ebb49497b251fa1603fef61db2c61d74d2ee</sha1>
  </revision>
  <revision>
    <id>114</id>
    <parentid>113</parentid>
    <timestamp>2011-01-25T21:45:21Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>/* For all players */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2046" xml:space="preserve">Parameters that are marked with &lt;&gt; (example: &lt;player&gt;) are required. Parameters marked with [] (example: [reason]) are optional. Usage example: "/kick johntheminer this is test kick"

== For all players ==
{| class="wikitable"
|-
! Command
! Description
|-
|/help [&lt;commandname&gt;]
|Displays help text showing all commands and their description, or, if &lt;commandname&gt; given, displays description text for that command.
|-
|/players, /who
|Lists online players
|-
|/about
|Server name &amp; version
|-
|/rules
|Show server rules
|-
|/home
|Teleports player to map spawn location
|-
|/motd
|Display Message Of The Day
|-
|/dnd
|Do Not Disturb - toggles whether the player receives chat &amp; private messages
|}

== Admin only ==
{| class="wikitable"
|-
! Command
! Description
|-
|%text
|Servermessage 
|-
|&amp;text
|Admin-only message
|-
|/kick &lt;player&gt; [reason]
|Kicks &lt;player&gt; with optional kick message
|-
|/ban &lt;player&gt; [reason]
|Bans (and kicks if online) &lt;player&gt; from server
|-
|/unban &lt;player&gt;
|Lift a ban
|-
|/save
|Manually save map to disc
|-
|/ctp &lt;x&gt; &lt;y&gt; &lt;z&gt;
|Teleport to coordinates (eg. /ctp 100 100 100)
|-
|/tp &lt;player&gt;
|Teleport yourself to &lt;player&gt;'s position
|-
|/tp &lt;player1&gt; &lt;player2&gt;
|Teleport &lt;player1&gt; to &lt;player2&gt;
|-
|/reload
|Reload admins and configuration
|-
|/give &lt;player&gt; &lt;id/alias&gt; [count]
|Gives &lt;player&gt; [count] pieces of &lt;id/alias&gt;. By default [count] = 1. Supports over 64 items. Aliases configurable in item_alias.cfg
|-
|/igive &lt;id/alias&gt; [count]
|Gives self [count] pieces of &lt;id/alias&gt;. By default [count] = 1.
|-
|/rules &lt;player&gt;
|Shows server rules (from rules.txt) to &lt;player&gt;
|-
|/gps [player] 
|Without [player] shows own coordinates &amp; heading. With [player] shows [player]'s coordinates &amp; heading
|-
|/settime &lt;time&gt;
|Sets server time. &lt;time&gt; = 0-24000 (0 and 24000 is day and about 15000 is night)
|-
|/mute &lt;player&gt; [reason]
|Mutes &lt;player&gt; with optional message
|-
|/unmute &lt;player&gt;
|Unmutes &lt;player&gt;
|-
|/regen
|Regenerates lightning
|-
|/sethealth &lt;player&gt; &lt;health&gt;
|Set &lt;player&gt;'s health. &lt;health&gt; = 0-20
|}</text>
    <sha1>10e6e7bb4ffedd6e8e2fc65ce1f6094f5da0ca6c</sha1>
  </revision>
  <revision>
    <id>115</id>
    <parentid>114</parentid>
    <timestamp>2011-01-25T21:46:41Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>/* Admin only */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1550" xml:space="preserve">Parameters that are marked with &lt;&gt; (example: &lt;player&gt;) are required. Parameters marked with [] (example: [reason]) are optional. Usage example: "/kick johntheminer this is test kick"

== For all players ==
{| class="wikitable"
|-
! Command
! Description
|-
|/help [&lt;commandname&gt;]
|Displays help text showing all commands and their description, or, if &lt;commandname&gt; given, displays description text for that command.
|-
|/players, /who
|Lists online players
|-
|/about
|Server name &amp; version
|-
|/rules
|Show server rules
|-
|/home
|Teleports player to map spawn location
|-
|/motd
|Display Message Of The Day
|-
|/dnd
|Do Not Disturb - toggles whether the player receives chat &amp; private messages
|}

== Admin only ==
{| class="wikitable"
|-
! Command
! Description
|-
|/save
|Manually save map to disc
|-
|/ctp &lt;x&gt; &lt;y&gt; &lt;z&gt;
|Teleport to coordinates (eg. /ctp 100 100 100)
|-
|/tp &lt;player&gt;
|Teleport yourself to &lt;player&gt;'s position
|-
|/tp &lt;player1&gt; &lt;player2&gt;
|Teleport &lt;player1&gt; to &lt;player2&gt;
|-
|/give &lt;player&gt; &lt;id/alias&gt; [count]
|Gives &lt;player&gt; [count] pieces of &lt;id/alias&gt;. By default [count] = 1. Supports over 64 items. Aliases configurable in item_alias.cfg
|-
|/i &lt;id/alias&gt; [count]
|Gives self [count] pieces of &lt;id/alias&gt;. By default [count] = 1.
|-
|/rules &lt;player&gt;
|Shows server rules (from rules.txt) to &lt;player&gt;
|-
|/gps [player] 
|Without [player] shows own coordinates &amp; heading. With [player] shows [player]'s coordinates &amp; heading
|-
|/settime &lt;time&gt;
|Sets server time. &lt;time&gt; = 0-24000 (0 and 24000 is day and about 15000 is night)
|}</text>
    <sha1>cebeed826989c8c7ccecb3c7de08d341eb9c96ae</sha1>
  </revision>
  <revision>
    <id>121</id>
    <parentid>115</parentid>
    <timestamp>2011-02-03T08:37:56Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <minor/>
    <comment>/* Admin only */  /world</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1657" xml:space="preserve">Parameters that are marked with &lt;&gt; (example: &lt;player&gt;) are required. Parameters marked with [] (example: [reason]) are optional. Usage example: "/kick johntheminer this is test kick"

== For all players ==
{| class="wikitable"
|-
! Command
! Description
|-
|/help [&lt;commandname&gt;]
|Displays help text showing all commands and their description, or, if &lt;commandname&gt; given, displays description text for that command.
|-
|/players, /who
|Lists online players
|-
|/about
|Server name &amp; version
|-
|/rules
|Show server rules
|-
|/home
|Teleports player to map spawn location
|-
|/motd
|Display Message Of The Day
|-
|/dnd
|Do Not Disturb - toggles whether the player receives chat &amp; private messages
|}

== Admin only ==
{| class="wikitable"
|-
! Command
! Description
|-
|/save
|Manually save map to disc
|-
|/ctp &lt;x&gt; &lt;y&gt; &lt;z&gt;
|Teleport to coordinates (eg. /ctp 100 100 100)
|-
|/tp &lt;player&gt;
|Teleport yourself to &lt;player&gt;'s position
|-
|/tp &lt;player1&gt; &lt;player2&gt;
|Teleport &lt;player1&gt; to &lt;player2&gt;
|-
|/give &lt;player&gt; &lt;id/alias&gt; [count]
|Gives &lt;player&gt; [count] pieces of &lt;id/alias&gt;. By default [count] = 1. Supports over 64 items. Aliases configurable in item_alias.cfg
|-
|/i &lt;id/alias&gt; [count]
|Gives self [count] pieces of &lt;id/alias&gt;. By default [count] = 1.
|-
|/rules &lt;player&gt;
|Shows server rules (from rules.txt) to &lt;player&gt;
|-
|/gps [player] 
|Without [player] shows own coordinates &amp; heading. With [player] shows [player]'s coordinates &amp; heading
|-
|/settime &lt;time&gt;
|Sets server time. &lt;time&gt; = 0-24000 (0 and 24000 is day and about 15000 is night)
|-
|/world &lt;worldnumber&gt;
|Teleport to another world defined in config.cfg. Worlds are in ALPHABETIC order.
|}</text>
    <sha1>9240d70278e13d1e060374355705c55c7c530548</sha1>
  </revision>
  <revision>
    <id>148</id>
    <parentid>121</parentid>
    <timestamp>2011-02-26T22:22:08Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1679" xml:space="preserve">Parameters that are marked with &lt;&gt; (example: &lt;player&gt;) are required. Parameters marked with [] (example: [reason]) are optional. Usage example: "/kick johntheminer this is test kick"

== For all players ==
{| class="wikitable"
|-
! Command
! Description
|-
|/help [&lt;commandname&gt;]
|Displays help text showing all commands and their description, or, if &lt;commandname&gt; given, displays description text for that command.
|-
|/players, /who
|Lists online players
|-
|/about
|Server name &amp; version
|-
|/rules
|Show server rules
|-
|/home
|Teleports player to map spawn location
|-
|/motd
|Display Message Of The Day
|-
|/dnd
|Do Not Disturb - toggles whether the player receives chat &amp; private messages
|}

== Admin only ==
{| class="wikitable"
|-
! Command
! Description
|-
|/save
|Manually save map to disc
|-
|/ctp &lt;x&gt; &lt;y&gt; &lt;z&gt;
|Teleport to coordinates (eg. /ctp 100 100 100)
|-
|/tp &lt;player&gt;
|Teleport yourself to &lt;player&gt;'s position
|-
|/tp &lt;player1&gt; &lt;player2&gt;
|Teleport &lt;player1&gt; to &lt;player2&gt;
|-
|/give &lt;player&gt; &lt;id/alias&gt; [count]
|Gives &lt;player&gt; [count] pieces of &lt;id/alias&gt;. By default [count] = 1. Supports over 64 items. Aliases configurable in item_alias.cfg
|-
|/i &lt;id/alias&gt; [count]
|Gives self [count] pieces of &lt;id/alias&gt;. By default [count] = 1.
|-
|/rules &lt;player&gt;
|Shows server rules (from rules.txt) to &lt;player&gt;
|-
|/gps [player] 
|Without [player] shows own coordinates &amp; heading. With [player] shows [player]'s coordinates &amp; heading
|-
|/settime &lt;time&gt;
|Sets server time. &lt;time&gt; = 0-24000 (0 and 24000 is day and about 15000 is night)
|-
|/world &lt;worldnumber&gt;
|Teleport to another world defined in config.cfg. Worlds are in ALPHABETIC order.
|}

[[Category:Plugins]]</text>
    <sha1>804a6b66c6d1ba2aa29002e5bcf3b383f73b513b</sha1>
  </revision>
  <revision>
    <id>150</id>
    <parentid>148</parentid>
    <timestamp>2011-02-26T22:36:49Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>Redirected page to [[Commands]]</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="21" xml:space="preserve">#REDIRECT[[Commands]]</text>
    <sha1>fd28a083e2d5ef73a6848f1fb9411b799f63d14d</sha1>
  </revision>
</page>
<page arvcontinue="20110116000803|101">
  <title>Plugin:Binlog</title>
  <ns>0</ns>
  <id>15</id>
  <revision>
    <id>116</id>
    <timestamp>2011-01-25T22:45:19Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>Created page with "{| class="wikitable" |- ! Command ! Description |- |/rollback [&lt;epochtime&gt;[&lt;nick&gt;]] |Rollback block changes for a specific timeframe and optionally user. With no arguments all bl..."</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="277" xml:space="preserve">{| class="wikitable"
|-
! Command
! Description
|-
|/rollback [&lt;epochtime&gt;[&lt;nick&gt;]]
|Rollback block changes for a specific timeframe and optionally user. With no arguments all blocks are reverted from the binary log.
|-
|/playback  [&lt;epochtime&gt;[&lt;nick&gt;]]
|not yet implemented
|}</text>
    <sha1>e52621c01b748bcdb66fd8d71f03aecd1cfbfa1f</sha1>
  </revision>
  <revision>
    <id>117</id>
    <parentid>116</parentid>
    <timestamp>2011-01-25T22:48:04Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="295" xml:space="preserve">{| class="wikitable"
|-
! Command
! Description
|-
|&lt;tt&gt;/rollback [&lt;epochtime&gt;[&lt;nick&gt;]]&lt;/tt&gt;
|Rollback block changes for a specific timeframe and optionally user. With no arguments all blocks are reverted from the binary log.
|-
|&lt;tt&gt;/playback  [&lt;epochtime&gt;[&lt;nick&gt;]]&lt;/tt&gt;
|not yet implemented
|}</text>
    <sha1>09cf77cc576ddbc90cd8429d09c5b947b5717b98</sha1>
  </revision>
  <revision>
    <id>118</id>
    <parentid>117</parentid>
    <timestamp>2011-01-25T22:50:06Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="603" xml:space="preserve">=Description=
The binlog plugin records block which are created and destroyed allowing players to rollback changes to the map.
=Commands=
{| class="wikitable"
|-
! Command
! Description
|-
|&lt;tt&gt;/rollback [&lt;epochtime&gt;[&lt;nick&gt;]]&lt;/tt&gt;
|Rollback block changes for a specific timeframe and optionally user. With no arguments all blocks are reverted from the binary log.
|-
|&lt;tt&gt;/playback  [&lt;epochtime&gt;[&lt;nick&gt;]]&lt;/tt&gt;
|not yet implemented
|}
=Config=
{| class="wikitable"
|-
! Config
! Description
|-
|enable_binary_log
|enables transaction logging
|-
|binary_log
|the filename to use for the transaction log
|}</text>
    <sha1>0307b338006772fd110e65b20d7926a0f59e81ca</sha1>
  </revision>
  <revision>
    <id>119</id>
    <parentid>118</parentid>
    <timestamp>2011-01-25T22:52:27Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="648" xml:space="preserve">=Description=
The binlog plugin records block which are created and destroyed allowing players to [http://www.youtube.com/watch?v=3MaApuaSVMM rollback changes to the map.]
=Commands=
{| class="wikitable"
|-
! Command
! Description
|-
|&lt;tt&gt;/rollback [&lt;epochtime&gt;[&lt;nick&gt;]]&lt;/tt&gt;
|Rollback block changes for a specific timeframe and optionally user. With no arguments all blocks are reverted from the binary log.
|-
|&lt;tt&gt;/playback  [&lt;epochtime&gt;[&lt;nick&gt;]]&lt;/tt&gt;
|not yet implemented
|}
=Config=
{| class="wikitable"
|-
! Config
! Description
|-
|enable_binary_log
|enables transaction logging
|-
|binary_log
|the filename to use for the transaction log
|}</text>
    <sha1>e4022c96ab759ee1c8a9b2d60db09e1cd75ef97c</sha1>
  </revision>
  <revision>
    <id>145</id>
    <parentid>119</parentid>
    <timestamp>2011-02-26T22:20:22Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="670" xml:space="preserve">=Description=
The binlog plugin records block which are created and destroyed allowing players to [http://www.youtube.com/watch?v=3MaApuaSVMM rollback changes to the map.]
=Commands=
{| class="wikitable"
|-
! Command
! Description
|-
|&lt;tt&gt;/rollback [&lt;epochtime&gt;[&lt;nick&gt;]]&lt;/tt&gt;
|Rollback block changes for a specific timeframe and optionally user. With no arguments all blocks are reverted from the binary log.
|-
|&lt;tt&gt;/playback  [&lt;epochtime&gt;[&lt;nick&gt;]]&lt;/tt&gt;
|not yet implemented
|}
=Config=
{| class="wikitable"
|-
! Config
! Description
|-
|enable_binary_log
|enables transaction logging
|-
|binary_log
|the filename to use for the transaction log
|}

[[Category:Plugins]]</text>
    <sha1>30fd51ab4fe65a16605404a63072ebce81614b2f</sha1>
  </revision>
</page>
<page arvcontinue="20110116000803|101">
  <title>Installation</title>
  <ns>0</ns>
  <id>3</id>
  <revision>
    <id>122</id>
    <parentid>96</parentid>
    <timestamp>2011-02-04T21:46:56Z</timestamp>
    <contributor>
      <username>Fishyghost</username>
      <id>17</id>
    </contributor>
    <comment>/* CentOS and Red Hat */  Added a workaround that I had to perform</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="9162" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 4 external libraries: ncurses (pdcurses on windows), zlib, libevent and libnoise (possibly from [https://github.com/qknight/libnoise https://github.com/qknight/libnoise]). The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

Download the latest zip file from mineserver.be/downloads and make a new folder on your desktop, and name it whatever you want
Extract the files from the zip into that folder and edit the configuration, make sure your name is on the roles.txt list for you to be admin
Goto ahead and run the mineserver bat file and the server will start

To get your ip address, goto www.cmyip.com

Edited by liamallan 

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

Most dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

However CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  sudo cp -R include /usr/local/include/noise
  sudo cp lib/* /usr/local/lib
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

You also have to copy the contents of the src folder of the libnoise package into a folder called libnoise within the mineserver src directory:

  change directory to your mineserver src directory
  mkdir libnoise
  cp -R /path/to/libnoise/src/* ./
  make

:)

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====

To install third party libraries on OS X, some convenient ways exist.
Note that zlib ships with OS X by default.

===== MacPorts or Fink =====

You can install zlib and libevent using Macports:

 sudo port install libevent

or Fink:

 sudo apt-get install libevent1

Either way, you will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

or Fink:

 sudo apt-get install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===== Homebrew =====

With homebrew installed, you can just install libevent:

 brew install libevent

A formular for libnoise can be found on [http://github.com/krono/homebrew krono’s homebrew fork].
Using that, you can install libnoise just the same way:

 brew install libnoise

It does not depend on cmake and doxygen.

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that below.

'''NOTE'''! If you are using debian/ubuntu or similar use &lt;code&gt;make DEBIAN=1&lt;/code&gt; instead of &lt;code&gt;make&lt;/code&gt;

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

===== Macports =====

You can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

  cd src
  CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===== Fink =====

You can build, ensuring that you point the compiler to any Fink-installed headers and libraries:

  cd src
  CXXFLAGS=-I/sw/include LDFLAGS=-L/sw/lib make


===== Homebrew =====

Homebrew installs in a System-Known location, so you just have to make.
  cd src
  make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>bf67754656970067d180852be05bf5461cf97ca7</sha1>
  </revision>
  <revision>
    <id>123</id>
    <parentid>122</parentid>
    <timestamp>2011-02-05T08:08:57Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>/* Installing prerequisites */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="9336" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 4 external libraries: ncurses (pdcurses on windows), zlib, libevent and libnoise (possibly from [https://github.com/qknight/libnoise https://github.com/qknight/libnoise]). The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

Download the latest zip file from mineserver.be/downloads and make a new folder on your desktop, and name it whatever you want
Extract the files from the zip into that folder and edit the configuration, make sure your name is on the roles.txt list for you to be admin
Goto ahead and run the mineserver bat file and the server will start

To get your ip address, goto www.cmyip.com

Edited by liamallan 

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

Most dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

However CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  sudo cp -R include /usr/local/include/noise
  sudo cp lib/* /usr/local/lib
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

You also have to copy the contents of the src folder of the libnoise package into a folder called libnoise within the mineserver src directory:

  change directory to your mineserver src directory
  mkdir libnoise
  cp -R /path/to/libnoise/src/* ./
  make

:)

====BSD Variants====
You may need to create the proper link for the libnoise shared object file:

&lt;code&gt;ln -s /usr/local/lib/libnoise.so.0 /usr/local/lib/libnoise.so&lt;/code&gt;

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====

To install third party libraries on OS X, some convenient ways exist.
Note that zlib ships with OS X by default.

===== MacPorts or Fink =====

You can install zlib and libevent using Macports:

 sudo port install libevent

or Fink:

 sudo apt-get install libevent1

Either way, you will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

or Fink:

 sudo apt-get install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===== Homebrew =====

With homebrew installed, you can just install libevent:

 brew install libevent

A formular for libnoise can be found on [http://github.com/krono/homebrew krono’s homebrew fork].
Using that, you can install libnoise just the same way:

 brew install libnoise

It does not depend on cmake and doxygen.

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that below.

'''NOTE'''! If you are using debian/ubuntu or similar use &lt;code&gt;make DEBIAN=1&lt;/code&gt; instead of &lt;code&gt;make&lt;/code&gt;

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

===== Macports =====

You can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

  cd src
  CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===== Fink =====

You can build, ensuring that you point the compiler to any Fink-installed headers and libraries:

  cd src
  CXXFLAGS=-I/sw/include LDFLAGS=-L/sw/lib make


===== Homebrew =====

Homebrew installs in a System-Known location, so you just have to make.
  cd src
  make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>8072a025bd5d5d7576d52c767462492400ac5333</sha1>
  </revision>
  <revision>
    <id>124</id>
    <parentid>123</parentid>
    <timestamp>2011-02-05T08:10:02Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>/* BSD Variants */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="9325" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 4 external libraries: ncurses (pdcurses on windows), zlib, libevent and libnoise (possibly from [https://github.com/qknight/libnoise https://github.com/qknight/libnoise]). The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

Download the latest zip file from mineserver.be/downloads and make a new folder on your desktop, and name it whatever you want
Extract the files from the zip into that folder and edit the configuration, make sure your name is on the roles.txt list for you to be admin
Goto ahead and run the mineserver bat file and the server will start

To get your ip address, goto www.cmyip.com

Edited by liamallan 

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

Most dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

However CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  sudo cp -R include /usr/local/include/noise
  sudo cp lib/* /usr/local/lib
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

You also have to copy the contents of the src folder of the libnoise package into a folder called libnoise within the mineserver src directory:

  change directory to your mineserver src directory
  mkdir libnoise
  cp -R /path/to/libnoise/src/* ./
  make

:)

====BSD Variants====
You may need to create the proper link for the libnoise shared object file:

  ln -s /usr/local/lib/libnoise.so.0 /usr/local/lib/libnoise.so

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====

To install third party libraries on OS X, some convenient ways exist.
Note that zlib ships with OS X by default.

===== MacPorts or Fink =====

You can install zlib and libevent using Macports:

 sudo port install libevent

or Fink:

 sudo apt-get install libevent1

Either way, you will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

or Fink:

 sudo apt-get install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===== Homebrew =====

With homebrew installed, you can just install libevent:

 brew install libevent

A formular for libnoise can be found on [http://github.com/krono/homebrew krono’s homebrew fork].
Using that, you can install libnoise just the same way:

 brew install libnoise

It does not depend on cmake and doxygen.

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that below.

'''NOTE'''! If you are using debian/ubuntu or similar use &lt;code&gt;make DEBIAN=1&lt;/code&gt; instead of &lt;code&gt;make&lt;/code&gt;

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

===== Macports =====

You can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

  cd src
  CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===== Fink =====

You can build, ensuring that you point the compiler to any Fink-installed headers and libraries:

  cd src
  CXXFLAGS=-I/sw/include LDFLAGS=-L/sw/lib make


===== Homebrew =====

Homebrew installs in a System-Known location, so you just have to make.
  cd src
  make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>b6e9c911c55eb03ed8bd822e312373096bb9e4f0</sha1>
  </revision>
  <revision>
    <id>125</id>
    <parentid>124</parentid>
    <timestamp>2011-02-05T08:10:33Z</timestamp>
    <contributor>
      <username>Nathacof</username>
      <id>4</id>
    </contributor>
    <comment>/* BSD Variants */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="9369" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 4 external libraries: ncurses (pdcurses on windows), zlib, libevent and libnoise (possibly from [https://github.com/qknight/libnoise https://github.com/qknight/libnoise]). The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

Download the latest zip file from mineserver.be/downloads and make a new folder on your desktop, and name it whatever you want
Extract the files from the zip into that folder and edit the configuration, make sure your name is on the roles.txt list for you to be admin
Goto ahead and run the mineserver bat file and the server will start

To get your ip address, goto www.cmyip.com

Edited by liamallan 

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

Most dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

However CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  sudo cp -R include /usr/local/include/noise
  sudo cp lib/* /usr/local/lib
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

You also have to copy the contents of the src folder of the libnoise package into a folder called libnoise within the mineserver src directory:

  change directory to your mineserver src directory
  mkdir libnoise
  cp -R /path/to/libnoise/src/* ./
  make

:)

====BSD Variants====
Due to a problem with the libnoise package, you may need to create the proper link for the libnoise shared object file:

  ln -s /usr/local/lib/libnoise.so.0 /usr/local/lib/libnoise.so

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====

To install third party libraries on OS X, some convenient ways exist.
Note that zlib ships with OS X by default.

===== MacPorts or Fink =====

You can install zlib and libevent using Macports:

 sudo port install libevent

or Fink:

 sudo apt-get install libevent1

Either way, you will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

or Fink:

 sudo apt-get install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===== Homebrew =====

With homebrew installed, you can just install libevent:

 brew install libevent

A formular for libnoise can be found on [http://github.com/krono/homebrew krono’s homebrew fork].
Using that, you can install libnoise just the same way:

 brew install libnoise

It does not depend on cmake and doxygen.

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that below.

'''NOTE'''! If you are using debian/ubuntu or similar use &lt;code&gt;make DEBIAN=1&lt;/code&gt; instead of &lt;code&gt;make&lt;/code&gt;

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

===== Macports =====

You can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

  cd src
  CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===== Fink =====

You can build, ensuring that you point the compiler to any Fink-installed headers and libraries:

  cd src
  CXXFLAGS=-I/sw/include LDFLAGS=-L/sw/lib make


===== Homebrew =====

Homebrew installs in a System-Known location, so you just have to make.
  cd src
  make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>e7bf31cf750e8a427f01871d15a1843f7567cbd6</sha1>
  </revision>
</page>
<page arvcontinue="20110116000803|101">
  <title>Template:APIFunctVoid</title>
  <ns>10</ns>
  <id>16</id>
  <revision>
    <id>126</id>
    <timestamp>2011-02-26T18:13:50Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>Created page with "&lt;noinclude&gt; = Usage = &lt;pre&gt;&lt;nowiki&gt; {{APIFunctVoid|function name|parameter|parameter type|parameter info|description}} &lt;/nowiki&gt;&lt;/pre&gt; = Template Preview = {{APIFunctVoid|functio..."</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="704" xml:space="preserve">&lt;noinclude&gt;
= Usage =
&lt;pre&gt;&lt;nowiki&gt;
{{APIFunctVoid|function name|parameter|parameter type|parameter info|description}}
&lt;/nowiki&gt;&lt;/pre&gt;
= Template Preview =
{{APIFunctVoid|function name|parameter|parameter type|parameter info|description}}
= Template =
&lt;/noinclude&gt;
{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''{{{1}}}'''
| class="col1" | {{{2}}}
| class="col2" | {{{3}}}
| class="col3" | {{{4}}}
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row3"
| class="col0" colspan="4" | {{{5}}}
|}</text>
    <sha1>eef890825c8bd7d8a3c08465796dd1d119df9528</sha1>
  </revision>
</page>
<page arvcontinue="20110116000803|101">
  <title>Template:APIFunct1</title>
  <ns>10</ns>
  <id>17</id>
  <revision>
    <id>127</id>
    <timestamp>2011-02-26T18:16:35Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>Created page with "&lt;noinclude&gt; = Usage = &lt;pre&gt;&lt;nowiki&gt; {{APIFunct1|function name|parameter|parameter type|parameter info|return value|description}} &lt;/nowiki&gt;&lt;/pre&gt; = Template Preview = {{APIFunct1|..."</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="727" xml:space="preserve">&lt;noinclude&gt;
= Usage =
&lt;pre&gt;&lt;nowiki&gt;
{{APIFunct1|function name|parameter|parameter type|parameter info|return value|description}}
&lt;/nowiki&gt;&lt;/pre&gt;
= Template Preview =
{{APIFunct1|function name|parameter|parameter type|parameter info|return value|description}}
= Template =
&lt;/noinclude&gt;
{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''{{{1}}}'''
| class="col1" | {{{2}}}
| class="col2" | {{{3}}}
| class="col3" | {{{4}}}
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | {{{5}}}
|- class="row3"
| class="col0" colspan="4" | {{{6}}}
|}</text>
    <sha1>fe620d3c9c602993be421eea43d8e186f81a8798</sha1>
  </revision>
</page>
<page arvcontinue="20110116000803|101">
  <title>Template:APIFunct2</title>
  <ns>10</ns>
  <id>18</id>
  <revision>
    <id>128</id>
    <timestamp>2011-02-26T18:25:59Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>Created page with "&lt;noinclude&gt; = Usage = &lt;pre&gt;&lt;nowiki&gt; {{APIFunct2|function name|parameter1|parameter type1|parameter info1|parameter2|parameter type2|parameter info2|return value|description}} &lt;/n..."</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="910" xml:space="preserve">&lt;noinclude&gt;
= Usage =
&lt;pre&gt;&lt;nowiki&gt;
{{APIFunct2|function name|parameter1|parameter type1|parameter info1|parameter2|parameter type2|parameter info2|return value|description}}
&lt;/nowiki&gt;&lt;/pre&gt;
= Template Preview =
{{APIFunct2|function name|parameter1|parameter type1|parameter info1|parameter2|parameter type2|parameter info2|return value|description}}
= Template =
&lt;/noinclude&gt;
{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="2" | '''{{{1}}}'''
| class="col1" | {{{2}}}
| class="col2" | {{{3}}}
| class="col3" | {{{4}}}
|- class="row2"
| class="col1" | {{{5}}}
| class="col2" | {{{6}}}
| class="col3" | {{{7}}}
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | {{{8}}}
|- class="row4"
| class="col0" colspan="4" | {{{9}}}
|}</text>
    <sha1>18c48e4041c54e2943bea3179dd64eb10940321d</sha1>
  </revision>
</page>
<page arvcontinue="20110116000803|101">
  <title>Template:APIFunct6</title>
  <ns>10</ns>
  <id>19</id>
  <revision>
    <id>130</id>
    <timestamp>2011-02-26T18:30:52Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>Created page with "{| class="wikitable" |- class="row0" ! class="col0" | Function ! class="col1" | Parameter name ! class="col2" | Parameter type ! class="col3" | Parameter info |- class="row1" | c..."</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="909" xml:space="preserve">{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''{{{1}}}'''
| class="col1" | {{{2}}}
| class="col2" | {{{3}}}
| class="col3" | {{{4}}}
|- class="row2"
| class="col1" | {{{5}}}
| class="col2" | {{{6}}}
| class="col3" | {{{7}}}
|- class="row3"
| class="col1" | {{{8}}}
| class="col2" | {{{9}}}
| class="col3" | {{{10}}}
|- class="row4"
| class="col1" | {{{11}}}
| class="col2" | {{{12}}}
| class="col3" | {{{13}}}
|- class="row4"
| class="col1" | {{{14}}}
| class="col2" | {{{15}}}
| class="col3" | {{{16}}}
|- class="row5"
| class="col1" | {{{17}}}
| class="col2" | {{{18}}}
| class="col3" | {{{19}}}
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | {{{20}}}
|- class="row7"
| class="col0" colspan="4" | {{{21}}}
|}</text>
    <sha1>6f3d7eff0d58d5ad6b01aa7c10bef148dce550e6</sha1>
  </revision>
</page>
<page arvcontinue="20110116000803|101">
  <title>Template:APIFunct7</title>
  <ns>10</ns>
  <id>20</id>
  <revision>
    <id>132</id>
    <timestamp>2011-02-26T19:48:24Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>Created page with "{| class="wikitable" |- class="row0" ! class="col0" | Function ! class="col1" | Parameter name ! class="col2" | Parameter type ! class="col3" | Parameter info |- class="row1" | c..."</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1003" xml:space="preserve">{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''{{{1}}}'''
| class="col1" | {{{2}}}
| class="col2" | {{{3}}}
| class="col3" | {{{4}}}
|- class="row2"
| class="col1" | {{{5}}}
| class="col2" | {{{6}}}
| class="col3" | {{{7}}}
|- class="row3"
| class="col1" | {{{8}}}
| class="col2" | {{{9}}}
| class="col3" | {{{10}}}
|- class="row4"
| class="col1" | {{{11}}}
| class="col2" | {{{12}}}
| class="col3" | {{{13}}}
|- class="row4"
| class="col1" | {{{14}}}
| class="col2" | {{{15}}}
| class="col3" | {{{16}}}
|- class="row5"
| class="col1" | {{{17}}}
| class="col2" | {{{18}}}
| class="col3" | {{{19}}}
|- class="row6"
| class="col1" | {{{20}}}
| class="col2" | {{{21}}}
| class="col3" | {{{22}}}
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | {{{23}}}
|- class="row7"
| class="col0" colspan="4" | {{{24}}}
|}</text>
    <sha1>cc543c97300d6229ef42a2e76bcc923bd0bf4ec0</sha1>
  </revision>
  <revision>
    <id>135</id>
    <parentid>132</parentid>
    <timestamp>2011-02-26T20:20:20Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1003" xml:space="preserve">{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="7" | '''{{{1}}}'''
| class="col1" | {{{2}}}
| class="col2" | {{{3}}}
| class="col3" | {{{4}}}
|- class="row2"
| class="col1" | {{{5}}}
| class="col2" | {{{6}}}
| class="col3" | {{{7}}}
|- class="row3"
| class="col1" | {{{8}}}
| class="col2" | {{{9}}}
| class="col3" | {{{10}}}
|- class="row4"
| class="col1" | {{{11}}}
| class="col2" | {{{12}}}
| class="col3" | {{{13}}}
|- class="row4"
| class="col1" | {{{14}}}
| class="col2" | {{{15}}}
| class="col3" | {{{16}}}
|- class="row5"
| class="col1" | {{{17}}}
| class="col2" | {{{18}}}
| class="col3" | {{{19}}}
|- class="row6"
| class="col1" | {{{20}}}
| class="col2" | {{{21}}}
| class="col3" | {{{22}}}
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | {{{23}}}
|- class="row7"
| class="col0" colspan="4" | {{{24}}}
|}</text>
    <sha1>f621ada07d8de1fea4abcdc48b53c9aec0bd8f2b</sha1>
  </revision>
</page>
<page arvcontinue="20110116000803|101">
  <title>Template:APIFunct8</title>
  <ns>10</ns>
  <id>21</id>
  <revision>
    <id>133</id>
    <timestamp>2011-02-26T20:07:20Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>Created page with "{| class="wikitable" |- class="row0" ! class="col0" | Function ! class="col1" | Parameter name ! class="col2" | Parameter type ! class="col3" | Parameter info |- class="row1" | c..."</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1097" xml:space="preserve">{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''{{{1}}}'''
| class="col1" | {{{2}}}
| class="col2" | {{{3}}}
| class="col3" | {{{4}}}
|- class="row2"
| class="col1" | {{{5}}}
| class="col2" | {{{6}}}
| class="col3" | {{{7}}}
|- class="row3"
| class="col1" | {{{8}}}
| class="col2" | {{{9}}}
| class="col3" | {{{10}}}
|- class="row4"
| class="col1" | {{{11}}}
| class="col2" | {{{12}}}
| class="col3" | {{{13}}}
|- class="row4"
| class="col1" | {{{14}}}
| class="col2" | {{{15}}}
| class="col3" | {{{16}}}
|- class="row5"
| class="col1" | {{{17}}}
| class="col2" | {{{18}}}
| class="col3" | {{{19}}}
|- class="row6"
| class="col1" | {{{20}}}
| class="col2" | {{{21}}}
| class="col3" | {{{22}}}
|- class="row7"
| class="col1" | {{{21}}}
| class="col2" | {{{22}}}
| class="col3" | {{{23}}}
|- class="row8"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | {{{24}}}
|- class="row9"
| class="col0" colspan="4" | {{{25}}}
|}</text>
    <sha1>b4eb4e1ceae0f9bb323c04ea5d02df138e8380af</sha1>
  </revision>
  <revision>
    <id>136</id>
    <parentid>133</parentid>
    <timestamp>2011-02-26T20:20:43Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1097" xml:space="preserve">{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="8" | '''{{{1}}}'''
| class="col1" | {{{2}}}
| class="col2" | {{{3}}}
| class="col3" | {{{4}}}
|- class="row2"
| class="col1" | {{{5}}}
| class="col2" | {{{6}}}
| class="col3" | {{{7}}}
|- class="row3"
| class="col1" | {{{8}}}
| class="col2" | {{{9}}}
| class="col3" | {{{10}}}
|- class="row4"
| class="col1" | {{{11}}}
| class="col2" | {{{12}}}
| class="col3" | {{{13}}}
|- class="row4"
| class="col1" | {{{14}}}
| class="col2" | {{{15}}}
| class="col3" | {{{16}}}
|- class="row5"
| class="col1" | {{{17}}}
| class="col2" | {{{18}}}
| class="col3" | {{{19}}}
|- class="row6"
| class="col1" | {{{20}}}
| class="col2" | {{{21}}}
| class="col3" | {{{22}}}
|- class="row7"
| class="col1" | {{{21}}}
| class="col2" | {{{22}}}
| class="col3" | {{{23}}}
|- class="row8"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | {{{24}}}
|- class="row9"
| class="col0" colspan="4" | {{{25}}}
|}</text>
    <sha1>ee87eab05a5ee7d6029a603eace293ee9523b9e1</sha1>
  </revision>
  <revision>
    <id>138</id>
    <parentid>136</parentid>
    <timestamp>2011-02-26T20:23:56Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1097" xml:space="preserve">{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="8" | '''{{{1}}}'''
| class="col1" | {{{2}}}
| class="col2" | {{{3}}}
| class="col3" | {{{4}}}
|- class="row2"
| class="col1" | {{{5}}}
| class="col2" | {{{6}}}
| class="col3" | {{{7}}}
|- class="row3"
| class="col1" | {{{8}}}
| class="col2" | {{{9}}}
| class="col3" | {{{10}}}
|- class="row4"
| class="col1" | {{{11}}}
| class="col2" | {{{12}}}
| class="col3" | {{{13}}}
|- class="row4"
| class="col1" | {{{14}}}
| class="col2" | {{{15}}}
| class="col3" | {{{16}}}
|- class="row5"
| class="col1" | {{{17}}}
| class="col2" | {{{18}}}
| class="col3" | {{{19}}}
|- class="row6"
| class="col1" | {{{20}}}
| class="col2" | {{{21}}}
| class="col3" | {{{22}}}
|- class="row7"
| class="col1" | {{{23}}}
| class="col2" | {{{24}}}
| class="col3" | {{{25}}}
|- class="row8"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | {{{26}}}
|- class="row9"
| class="col0" colspan="4" | {{{27}}}
|}</text>
    <sha1>9cf1dce4d064731f44fa5009e456382325ba596c</sha1>
  </revision>
</page>
<page arvcontinue="20110116000803|101">
  <title>Template:APIFunct4</title>
  <ns>10</ns>
  <id>22</id>
  <revision>
    <id>134</id>
    <timestamp>2011-02-26T20:20:09Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>Created page with "{| class="wikitable" |- class="row0" ! class="col0" | Function ! class="col1" | Parameter name ! class="col2" | Parameter type ! class="col3" | Parameter info |- class="row1" | c..."</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="721" xml:space="preserve">{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''{{{1}}}'''
| class="col1" | {{{2}}}
| class="col2" | {{{3}}}
| class="col3" | {{{4}}}
|- class="row2"
| class="col1" | {{{5}}}
| class="col2" | {{{6}}}
| class="col3" | {{{7}}}
|- class="row3"
| class="col1" | {{{8}}}
| class="col2" | {{{9}}}
| class="col3" | {{{10}}}
|- class="row4"
| class="col1" | {{{11}}}
| class="col2" | {{{12}}}
| class="col3" | {{{13}}}
|- class="row5"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | {{{14}}}
|- class="row6"
| class="col0" colspan="4" | {{{15}}}
|}</text>
    <sha1>2d8069280a6b9281a0ac90aebcba7196a55c92d8</sha1>
  </revision>
</page>
<page arvcontinue="20110116000803|101">
  <title>Template:APIFunct5</title>
  <ns>10</ns>
  <id>23</id>
  <revision>
    <id>139</id>
    <timestamp>2011-02-26T20:27:38Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>Created page with "{| class="wikitable" |- class="row0" ! class="col0" | Function ! class="col1" | Parameter name ! class="col2" | Parameter type ! class="col3" | Parameter info |- class="row1" | c..."</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="815" xml:space="preserve">{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''{{{1}}}'''
| class="col1" | {{{2}}}
| class="col2" | {{{3}}}
| class="col3" | {{{4}}}
|- class="row2"
| class="col1" | {{{5}}}
| class="col2" | {{{6}}}
| class="col3" | {{{7}}}
|- class="row3"
| class="col1" | {{{8}}}
| class="col2" | {{{9}}}
| class="col3" | {{{10}}}
|- class="row4"
| class="col1" | {{{11}}}
| class="col2" | {{{12}}}
| class="col3" | {{{13}}}
|- class="row4"
| class="col1" | {{{14}}}
| class="col2" | {{{15}}}
| class="col3" | {{{16}}}
|- class="row5"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | {{{17}}}
|- class="row6"
| class="col0" colspan="4" | {{{18}}}
|}</text>
    <sha1>6a206a1150a6b3012270cc9a898a276d73db28b5</sha1>
  </revision>
</page>
<page arvcontinue="20110116000803|101">
  <title>Talk:Plugin API</title>
  <ns>1</ns>
  <id>9</id>
  <revision>
    <id>141</id>
    <parentid>88</parentid>
    <timestamp>2011-02-26T21:55:02Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>/* ToDo */ new section</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="778" xml:space="preserve">=A few Questions=
* There's no &lt;code&gt;sendBlock()&lt;/code&gt; in the plugin_api.h file? [[User:Nathacof|Nathacof]]
It's done automatically on setBlock() --[[User:Fador|Fador]] 00:14, 8 January 2011 (EET)
* Why is &lt;code&gt;dtos()&lt;/code&gt; defined in command.cpp but referenced in the example plugin? [[User:Nathacof|Nathacof]]
Now it's in the example --[[User:Fador|Fador]] 00:14, 8 January 2011 (EET)
* How do I get a callback function to accept a User object if I do not include the class files in my plugin? [[User:Nathacof|Nathacof]]
Users are referenced by the name (char *), no objects are used --[[User:Fador|Fador]] 00:14, 8 January 2011 (EET)

== ToDo ==

When work on mob functions is finished, should be documentated here. [[User:Delirium|Delirium]] 23:55, 26 February 2011 (EET)</text>
    <sha1>b34c3941a44030c157873f595112c3ffa86effc9</sha1>
  </revision>
</page>
<page arvcontinue="20110116000803|101">
  <title>Moving over from official server</title>
  <ns>0</ns>
  <id>24</id>
  <revision>
    <id>142</id>
    <timestamp>2011-02-26T22:18:08Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>Created page with "If you have already a working minecraft server, but want to use Mineserver, you can easily move over!  =Preperation= First of all, make a backup of your whole minecraft server. I..."</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="847" xml:space="preserve">If you have already a working minecraft server, but want to use Mineserver, you can easily move over!

=Preperation=
First of all, make a backup of your whole minecraft server. If anything went differently form your expectations, you can always go back.
Second, make sure your Minecraft world is in "old" Beta 1.2 File format. As of 26.2.2011, Mineserver does not support the new Beta 1.3 File format. Beta 1.3 clients can connect tough.

=Do the work=
[[Install|Installation]] Mineserver in a directory on your server. Edit the settings file to fit your needs, copy your world to the desired path and make sure the path is correctly specified in the settings. That's it! You can start Mineserver and start playing.

=What's about plugins?=
At the moment, there are not many [[plugins]]. But you can write your own - just check the [[Plugin API]].</text>
    <sha1>d7e97e0d5e8482e125eb8fecd4e5c68729ed8199</sha1>
  </revision>
  <revision>
    <id>143</id>
    <parentid>142</parentid>
    <timestamp>2011-02-26T22:18:20Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>/* Preperation */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="847" xml:space="preserve">If you have already a working minecraft server, but want to use Mineserver, you can easily move over!

=Preparation=
First of all, make a backup of your whole minecraft server. If anything went differently form your expectations, you can always go back.
Second, make sure your Minecraft world is in "old" Beta 1.2 File format. As of 26.2.2011, Mineserver does not support the new Beta 1.3 File format. Beta 1.3 clients can connect tough.

=Do the work=
[[Install|Installation]] Mineserver in a directory on your server. Edit the settings file to fit your needs, copy your world to the desired path and make sure the path is correctly specified in the settings. That's it! You can start Mineserver and start playing.

=What's about plugins?=
At the moment, there are not many [[plugins]]. But you can write your own - just check the [[Plugin API]].</text>
    <sha1>436e425cac4939474aca4d2fd09750904acbbec7</sha1>
  </revision>
  <revision>
    <id>144</id>
    <parentid>143</parentid>
    <timestamp>2011-02-26T22:18:36Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>/* Do the work */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="847" xml:space="preserve">If you have already a working minecraft server, but want to use Mineserver, you can easily move over!

=Preparation=
First of all, make a backup of your whole minecraft server. If anything went differently form your expectations, you can always go back.
Second, make sure your Minecraft world is in "old" Beta 1.2 File format. As of 26.2.2011, Mineserver does not support the new Beta 1.3 File format. Beta 1.3 clients can connect tough.

=Do the work=
[[Installation|Install]] Mineserver in a directory on your server. Edit the settings file to fit your needs, copy your world to the desired path and make sure the path is correctly specified in the settings. That's it! You can start Mineserver and start playing.

=What's about plugins?=
At the moment, there are not many [[plugins]]. But you can write your own - just check the [[Plugin API]].</text>
    <sha1>57d829b25e480cbbb5da55e16fbd63fa868cd556</sha1>
  </revision>
</page>
<page arvcontinue="20110116000803|101">
  <title>Category:Plugins</title>
  <ns>14</ns>
  <id>25</id>
  <revision>
    <id>146</id>
    <timestamp>2011-02-26T22:20:49Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>Created page with "Here is a list of all availiable plugins for Mineserver."</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="56" xml:space="preserve">Here is a list of all availiable plugins for Mineserver.</text>
    <sha1>1f194f4a3722b3eaa09c8d0e3ac70b40501c8edc</sha1>
  </revision>
  <revision>
    <id>147</id>
    <parentid>146</parentid>
    <timestamp>2011-02-26T22:21:23Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="781" xml:space="preserve">== Current plugins for Mineserver ==
Notice that plugins may have limited functionality and they are still being developed.
;[[Plugin:Commands|Commands]]
:Add some commands to game (Included)
;[[Plugin:Ncursesui|Ncurses UI]]
:Nice ui for server (Included)
;[[Plugin:Binlog|Binlog]]
:Log and rollback block changes(Included)
;[[Plugin:nBreak|nBreak]]
:Notch-style block breaking(Included)
;[[Plugin:Filelog|Filelog]]
:Log chat and stdout to files (Included)
;[[Plugin:ircchat|Ircchat]]
:Bridge between irc and minecraft chat (https://github.com/bluepeppers/mineserver/tree/master/plugins/ircchat)
;[[Plugin:Nether|Nether]]
:needed for nether-normal world portals (Included)

'''Note:''' Those that are Included can be found at https://github.com/fador/mineserver/tree/master/plugins</text>
    <sha1>320d343064c74bdde33fba8252ffa1dd620fd757</sha1>
  </revision>
</page>
<page arvcontinue="20110226223740|151">
  <title>Plugin:Binlog</title>
  <ns>0</ns>
  <id>15</id>
  <revision>
    <id>151</id>
    <parentid>145</parentid>
    <timestamp>2011-02-26T22:37:40Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>Redirected page to [[Binlog]]</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="19" xml:space="preserve">#REDIRECT[[Binlog]]</text>
    <sha1>2dd9ab1d02070ec45a916d1d9680044d94ddc1f4</sha1>
  </revision>
</page>
<page arvcontinue="20110226223740|151">
  <title>Binlog</title>
  <ns>0</ns>
  <id>26</id>
  <revision>
    <id>152</id>
    <timestamp>2011-02-26T22:37:46Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>Created page with "=Description= The binlog plugin records block which are created and destroyed allowing players to [http://www.youtube.com/watch?v=3MaApuaSVMM rollback changes to the map.] =Comma..."</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="670" xml:space="preserve">=Description=
The binlog plugin records block which are created and destroyed allowing players to [http://www.youtube.com/watch?v=3MaApuaSVMM rollback changes to the map.]
=Commands=
{| class="wikitable"
|-
! Command
! Description
|-
|&lt;tt&gt;/rollback [&lt;epochtime&gt;[&lt;nick&gt;]]&lt;/tt&gt;
|Rollback block changes for a specific timeframe and optionally user. With no arguments all blocks are reverted from the binary log.
|-
|&lt;tt&gt;/playback  [&lt;epochtime&gt;[&lt;nick&gt;]]&lt;/tt&gt;
|not yet implemented
|}
=Config=
{| class="wikitable"
|-
! Config
! Description
|-
|enable_binary_log
|enables transaction logging
|-
|binary_log
|the filename to use for the transaction log
|}

[[Category:Plugins]]</text>
    <sha1>30fd51ab4fe65a16605404a63072ebce81614b2f</sha1>
  </revision>
  <revision>
    <id>161</id>
    <parentid>152</parentid>
    <timestamp>2011-02-26T23:11:07Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="687" xml:space="preserve">=Description=
The binlog plugin records block which are created and destroyed allowing players to [http://www.youtube.com/watch?v=3MaApuaSVMM rollback changes to the map.]
=Commands=
{| class="wikitable"
|-
! Command
! Description
|-
|&lt;tt&gt;/rollback [&lt;epochtime&gt;[&lt;nick&gt;]]&lt;/tt&gt;
|Rollback block changes for a specific timeframe and optionally user. With no arguments all blocks are reverted from the binary log.
|-
|&lt;tt&gt;/playback  [&lt;epochtime&gt;[&lt;nick&gt;]]&lt;/tt&gt;
|not yet implemented
|}
=Config=
{| class="wikitable"
|-
! Config
! Description
|-
|enable_binary_log
|enables transaction logging
|-
|binary_log
|the filename to use for the transaction log
|}

[[Category:Plugins|Included Plugins]]</text>
    <sha1>daee3f175cffb0c33e259a9f2ec0eb6431cbea9b</sha1>
  </revision>
  <revision>
    <id>164</id>
    <parentid>161</parentid>
    <timestamp>2011-02-26T23:12:56Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="700" xml:space="preserve">=Description=
The binlog plugin records block which are created and destroyed allowing players to [http://www.youtube.com/watch?v=3MaApuaSVMM rollback changes to the map.]
=Commands=
{| class="wikitable"
|-
! Command
! Description
|-
|&lt;tt&gt;/rollback [&lt;epochtime&gt;[&lt;nick&gt;]]&lt;/tt&gt;
|Rollback block changes for a specific timeframe and optionally user. With no arguments all blocks are reverted from the binary log.
|-
|&lt;tt&gt;/playback  [&lt;epochtime&gt;[&lt;nick&gt;]]&lt;/tt&gt;
|not yet implemented
|}
=Config=
{| class="wikitable"
|-
! Config
! Description
|-
|enable_binary_log
|enables transaction logging
|-
|binary_log
|the filename to use for the transaction log
|}

[[Category:Plugins]]
[[Category:Included Plugins]]</text>
    <sha1>a05252ded12b366ec6b607664d76f8a70437ac2e</sha1>
  </revision>
</page>
<page arvcontinue="20110226223740|151">
  <title>Category:Plugins</title>
  <ns>14</ns>
  <id>25</id>
  <revision>
    <id>153</id>
    <parentid>147</parentid>
    <timestamp>2011-02-26T22:38:10Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="645" xml:space="preserve">== Current plugins for Mineserver ==
Notice that plugins may have limited functionality and they are still being developed.
;[[Plugin:Ncursesui|Ncurses UI]]
:Nice ui for server (Included)
;[[Plugin:nBreak|nBreak]]
:Notch-style block breaking(Included)
;[[Plugin:Filelog|Filelog]]
:Log chat and stdout to files (Included)
;[[Plugin:ircchat|Ircchat]]
:Bridge between irc and minecraft chat (https://github.com/bluepeppers/mineserver/tree/master/plugins/ircchat)
;[[Plugin:Nether|Nether]]
:needed for nether-normal world portals (Included)

'''Note:''' Those that are Included can be found at https://github.com/fador/mineserver/tree/master/plugins</text>
    <sha1>44157794a510adf06d70f2e693462074bb39fd7e</sha1>
  </revision>
  <revision>
    <id>156</id>
    <parentid>153</parentid>
    <timestamp>2011-02-26T23:01:33Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>/* Current plugins for Mineserver */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="608" xml:space="preserve">== Current plugins for Mineserver ==
Notice that plugins may have limited functionality and they are still being developed.
;[[CursesUI|Curses UI]]
:Nice ui for server (Included)
;[[nBreak|nBreak]]
:Notch-style block breaking(Included)
;[[Filelog|Filelog]]
:Log chat and stdout to files (Included)
;[[ircchat|Ircchat]]
:Bridge between irc and minecraft chat (https://github.com/bluepeppers/mineserver/tree/master/plugins/ircchat)
;[[Nether|Nether]]
:needed for nether-normal world portals (Included)

'''Note:''' Those that are Included can be found at https://github.com/fador/mineserver/tree/master/plugins</text>
    <sha1>cf0f39252ab8a0082813543569a724790b6c3d71</sha1>
  </revision>
  <revision>
    <id>159</id>
    <parentid>156</parentid>
    <timestamp>2011-02-26T23:10:18Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>/* Current plugins for Mineserver */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="553" xml:space="preserve">== Current plugins for Mineserver ==
Notice that plugins may have limited functionality and they are still being developed.
;[[nBreak|nBreak]]
:Notch-style block breaking(Included)
;[[Filelog|Filelog]]
:Log chat and stdout to files (Included)
;[[ircchat|Ircchat]]
:Bridge between irc and minecraft chat (https://github.com/bluepeppers/mineserver/tree/master/plugins/ircchat)
;[[Nether|Nether]]
:needed for nether-normal world portals (Included)

'''Note:''' Those that are Included can be found at https://github.com/fador/mineserver/tree/master/plugins</text>
    <sha1>2a716ce71d1e87fd79786d760dfce47b3a4bec74</sha1>
  </revision>
  <revision>
    <id>166</id>
    <parentid>159</parentid>
    <timestamp>2011-02-26T23:14:25Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="604" xml:space="preserve">These Category contains all Plugins of Mineserver.
== Current plugins for Mineserver ==
Notice that plugins may have limited functionality and they are still being developed.
;[[nBreak|nBreak]]
:Notch-style block breaking(Included)
;[[Filelog|Filelog]]
:Log chat and stdout to files (Included)
;[[ircchat|Ircchat]]
:Bridge between irc and minecraft chat (https://github.com/bluepeppers/mineserver/tree/master/plugins/ircchat)
;[[Nether|Nether]]
:needed for nether-normal world portals (Included)

'''Note:''' Those that are Included can be found at https://github.com/fador/mineserver/tree/master/plugins</text>
    <sha1>de5b7a68f8cf39a8ee7b506800fa620e45c8f950</sha1>
  </revision>
  <revision>
    <id>167</id>
    <parentid>166</parentid>
    <timestamp>2011-02-27T09:56:30Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="603" xml:space="preserve">This Category contains all Plugins of Mineserver.
== Current plugins for Mineserver ==
Notice that plugins may have limited functionality and they are still being developed.
;[[nBreak|nBreak]]
:Notch-style block breaking(Included)
;[[Filelog|Filelog]]
:Log chat and stdout to files (Included)
;[[ircchat|Ircchat]]
:Bridge between irc and minecraft chat (https://github.com/bluepeppers/mineserver/tree/master/plugins/ircchat)
;[[Nether|Nether]]
:needed for nether-normal world portals (Included)

'''Note:''' Those that are Included can be found at https://github.com/fador/mineserver/tree/master/plugins</text>
    <sha1>bf5a1709bacc87060f1325c9aff0c722545ed135</sha1>
  </revision>
  <revision>
    <id>168</id>
    <parentid>167</parentid>
    <timestamp>2011-02-27T09:58:12Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="603" xml:space="preserve">This category contains all plugins of Mineserver.
== Current plugins for Mineserver ==
Notice that plugins may have limited functionality and they are still being developed.
;[[nBreak|nBreak]]
:Notch-style block breaking(Included)
;[[Filelog|Filelog]]
:Log chat and stdout to files (Included)
;[[ircchat|Ircchat]]
:Bridge between irc and minecraft chat (https://github.com/bluepeppers/mineserver/tree/master/plugins/ircchat)
;[[Nether|Nether]]
:needed for nether-normal world portals (Included)

'''Note:''' Those that are Included can be found at https://github.com/fador/mineserver/tree/master/plugins</text>
    <sha1>57acaa62a9d90626b001a9f543b25d95f2aa5e88</sha1>
  </revision>
  <revision>
    <id>189</id>
    <parentid>168</parentid>
    <timestamp>2011-03-01T19:42:14Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="922" xml:space="preserve">This category contains all plugins of Mineserver.
== Current plugins for Mineserver ==
Notice that plugins may have limited functionality and they are still being developed.
;[[Commands]]
:Chat commands
;[[CursesUI]]
:NCurses based ui for mineserver
;[[Binlog]]
:The binlog plugin records block which are created and destroyed allowing players to rollback changes to the map.
;[[nBreak|nBreak]]
:Notch-style block breaking(Included)
;[[Filelog|Filelog]]
:Log chat and stdout to files (Included)
;[[ircchat|Ircchat]]
:Bridge between irc and minecraft chat (https://github.com/bluepeppers/mineserver/tree/master/plugins/ircchat)
;[[Nether|Nether]]
:needed for nether-normal world portals (Included)
;[[PassiveMobs]]
:Adds passive mobs like sheeps and cows. Proof-of-concept. Good base for expanding/improving Mob AI

'''Note:''' Those that are Included can be found at https://github.com/fador/mineserver/tree/master/plugins</text>
    <sha1>03b8b6cd8623dffdfa7b033a82a3fb8c2df8056f</sha1>
  </revision>
  <revision>
    <id>190</id>
    <parentid>189</parentid>
    <timestamp>2011-03-01T19:43:07Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="928" xml:space="preserve">This category contains all plugins of Mineserver.
== Current plugins for Mineserver ==
Notice that plugins may have limited functionality and they are still being developed.
;[[Commands]]
:Basic chat commands
;[[CursesUI]]
:NCurses based ui for mineserver
;[[Binlog]]
:The binlog plugin records block which are created and destroyed allowing players to rollback changes to the map.
;[[nBreak|nBreak]]
:Notch-style block breaking(Included)
;[[Filelog|Filelog]]
:Log chat and stdout to files (Included)
;[[ircchat|Ircchat]]
:Bridge between irc and minecraft chat (https://github.com/bluepeppers/mineserver/tree/master/plugins/ircchat)
;[[Nether|Nether]]
:needed for nether-normal world portals (Included)
;[[PassiveMobs]]
:Adds passive mobs like sheeps and cows. Proof-of-concept. Good base for expanding/improving Mob AI

'''Note:''' Those that are Included can be found at https://github.com/fador/mineserver/tree/master/plugins</text>
    <sha1>dafd12648c46e5f552e03e7b1561d8de11dbe48c</sha1>
  </revision>
</page>
<page arvcontinue="20110226223740|151">
  <title>Plugins</title>
  <ns>0</ns>
  <id>13</id>
  <revision>
    <id>154</id>
    <parentid>112</parentid>
    <timestamp>2011-02-26T22:52:52Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>Replaced content with "#REDIRECT[Category:Plugins]"</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="27" xml:space="preserve">#REDIRECT[Category:Plugins]</text>
    <sha1>b394323cd828bb6c1aca81fb9e53de2d65d38733</sha1>
  </revision>
  <revision>
    <id>155</id>
    <parentid>154</parentid>
    <timestamp>2011-02-26T22:53:01Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>Redirected page to [[Category:Plugins]]</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="29" xml:space="preserve">#REDIRECT[[Category:Plugins]]</text>
    <sha1>68400b92f0fe79447ad09b3f81e6765a9e0e1361</sha1>
  </revision>
</page>
<page arvcontinue="20110226223740|151">
  <title>File:Cursesui.png</title>
  <ns>6</ns>
  <id>27</id>
  <revision>
    <id>157</id>
    <timestamp>2011-02-26T23:05:37Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>Screenshot of the main window of Mineservers GUI, CuresesUI.</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="60" xml:space="preserve">Screenshot of the main window of Mineservers GUI, CuresesUI.</text>
    <sha1>a6a34c9f4627a632d40aaeac36c8750799fb2afd</sha1>
  </revision>
</page>
<page arvcontinue="20110226223740|151">
  <title>CursesUI</title>
  <ns>0</ns>
  <id>28</id>
  <revision>
    <id>158</id>
    <timestamp>2011-02-26T23:09:38Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>Created page with "[[File:cursesui.png|300px|thumb|right|Screenshot of CursesUI]] CursesUI is a GUI for Mineserver. It's included in the default mineserver package. It has got a list of all online ..."</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="463" xml:space="preserve">[[File:cursesui.png|300px|thumb|right|Screenshot of CursesUI]]
CursesUI is a GUI for Mineserver. It's included in the default mineserver package.
It has got a list of all online players, the console and the chat log. Entered commands will be shown in the commmand history area.

'''Important: When you use the plugin, make sure you set the system.interface.use_cli config variable to false - otherwise CursesUI dows not function properly!'''

[[Category:Plugins]]</text>
    <sha1>136e73009b636ebf64a09354613adcaa39a36188</sha1>
  </revision>
  <revision>
    <id>163</id>
    <parentid>158</parentid>
    <timestamp>2011-02-26T23:12:35Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="493" xml:space="preserve">[[File:cursesui.png|300px|thumb|right|Screenshot of CursesUI]]
CursesUI is a GUI for Mineserver. It's included in the default mineserver package.
It has got a list of all online players, the console and the chat log. Entered commands will be shown in the commmand history area.

'''Important: When you use the plugin, make sure you set the system.interface.use_cli config variable to false - otherwise CursesUI dows not function properly!'''

[[Category:Plugins]]
[[Category:Included Plugins]]</text>
    <sha1>33a387b594e83fe69373f9ac602a74af049302d8</sha1>
  </revision>
</page>
<page arvcontinue="20110226223740|151">
  <title>Category:Included Plugins</title>
  <ns>14</ns>
  <id>29</id>
  <revision>
    <id>160</id>
    <timestamp>2011-02-26T23:10:44Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>Created page with "[[Category:Plugins]]"</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="20" xml:space="preserve">[[Category:Plugins]]</text>
    <sha1>38b1402fbf5a9990d36c505df6bc8ff85cd44b7a</sha1>
  </revision>
  <revision>
    <id>165</id>
    <parentid>160</parentid>
    <timestamp>2011-02-26T23:13:51Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="91" xml:space="preserve">Plugins listed here are included with the main package of Mineserver.

[[Category:Plugins]]</text>
    <sha1>8c0381da45f41f93148d096821fb692e98dcc447</sha1>
  </revision>
</page>
<page arvcontinue="20110226223740|151">
  <title>Commands</title>
  <ns>0</ns>
  <id>5</id>
  <revision>
    <id>162</id>
    <parentid>149</parentid>
    <timestamp>2011-02-26T23:12:15Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1709" xml:space="preserve">Parameters that are marked with &lt;&gt; (example: &lt;player&gt;) are required. Parameters marked with [] (example: [reason]) are optional. Usage example: "/kick johntheminer this is test kick"

== For all players ==
{| class="wikitable"
|-
! Command
! Description
|-
|/help [&lt;commandname&gt;]
|Displays help text showing all commands and their description, or, if &lt;commandname&gt; given, displays description text for that command.
|-
|/players, /who
|Lists online players
|-
|/about
|Server name &amp; version
|-
|/rules
|Show server rules
|-
|/home
|Teleports player to map spawn location
|-
|/motd
|Display Message Of The Day
|-
|/dnd
|Do Not Disturb - toggles whether the player receives chat &amp; private messages
|}

== Admin only ==
{| class="wikitable"
|-
! Command
! Description
|-
|/save
|Manually save map to disc
|-
|/ctp &lt;x&gt; &lt;y&gt; &lt;z&gt;
|Teleport to coordinates (eg. /ctp 100 100 100)
|-
|/tp &lt;player&gt;
|Teleport yourself to &lt;player&gt;'s position
|-
|/tp &lt;player1&gt; &lt;player2&gt;
|Teleport &lt;player1&gt; to &lt;player2&gt;
|-
|/give &lt;player&gt; &lt;id/alias&gt; [count]
|Gives &lt;player&gt; [count] pieces of &lt;id/alias&gt;. By default [count] = 1. Supports over 64 items. Aliases configurable in item_alias.cfg
|-
|/i &lt;id/alias&gt; [count]
|Gives self [count] pieces of &lt;id/alias&gt;. By default [count] = 1.
|-
|/rules &lt;player&gt;
|Shows server rules (from rules.txt) to &lt;player&gt;
|-
|/gps [player] 
|Without [player] shows own coordinates &amp; heading. With [player] shows [player]'s coordinates &amp; heading
|-
|/settime &lt;time&gt;
|Sets server time. &lt;time&gt; = 0-24000 (0 and 24000 is day and about 15000 is night)
|-
|/world &lt;worldnumber&gt;
|Teleport to another world defined in config.cfg. Worlds are in ALPHABETIC order.
|}

[[Category:Plugins]]
[[Category:Included Plugins]]</text>
    <sha1>b261227bd555cc9db5050ed8bbc156cbf470bbdb</sha1>
  </revision>
</page>
<page arvcontinue="20110226223740|151">
  <title>Plugin API</title>
  <ns>0</ns>
  <id>8</id>
  <revision>
    <id>169</id>
    <parentid>140</parentid>
    <timestamp>2011-02-27T21:03:44Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>/* Creating a plugin */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="19904" xml:space="preserve">Mineserver uses a C-plugin API which is described in this page.

==Creating a plugin==

You will need to include &lt;code&gt;plugin_api.h&lt;/code&gt; to your project.

...write some more stuff here...

Example plugin structure:

&lt;code&gt;
  #include &lt;stdio.h&gt;
#include &lt;stdlib.h&gt;
#include &lt;time.h&gt;
#include &lt;string.h&gt;
#include &lt;cstdlib&gt;
#include &lt;iostream&gt;

#define MINESERVER_C_API
#include "../src/plugin_api.h"
#include "../src/logtype.h"

#define PLUGIN_VERSION 1.0
double pluginVersion = PLUGIN_VERSION;

#define PLUGIN_NAME "samplePlugin"
const char* pluginName = PLUGIN_NAME;

const char* logSource = "plugin.screen";
mineserver_pointer_struct* mineserver;

 PLUGIN_API_EXPORT void CALLCONVERSION samplePlugin_init(mineserver_pointer_struct* mineserver_temp)
{
  mineserver = mineserver_temp;

  if (mineserver-&gt;plugin.getPluginVersion(pluginName) &gt; 0)
  {
    mineserver-&gt;logger.log(LogType::LOG_INFO, logSource, "The " PLUGIN_NAME " plugin is already loaded");
    return;
  }

  mineserver-&gt;logger.log(LogType::LOG_INFO, logSource, "Loaded " PLUGIN_NAME);
  mineserver-&gt;plugin.setPluginVersion(pluginName, pluginVersion);

}


PLUGIN_API_EXPORT void CALLCONVERSION samplePlugin_shutdown(void)
{
  if (mineserver-&gt;plugin.getPluginVersion(pluginName) &lt;= 0)
  {
    mineserver-&gt;logger.log(LogType::LOG_INFO, logSource, PLUGIN_NAME " is not loaded!");
    return;
  }
  mineserver-&gt;logger.log(LogType::LOG_INFO, logSource, PLUGIN_NAME " has been unloaded!");
}

&lt;/code&gt;

==Available functions==

===Mineserver===

====Chat====

{{APIFunct2|sendmsgTo|user|const char*|Username in null Terminated char array|msg|const char*|Message in null terminated char array|bool, telling it the user was found|Sends a message to specified ''user''}}

{{APIFunct1|sendmsg|msg|const char*|Message in null terminated char array|bool, telling it the user was found|Sends a message to all players, except they are in DND mode}}

{{APIFunct1|sendUserList|user|const char*|User in null terminated char array|bool, telling it the user was found|Sends the playerlist to ''user''}}

====Screen====

{{APIFunctVoid|log|msg|const char*|Message in null terminated char array|Prints message to server window}}

====Map====

{{APIFunct6|createPickupSpawn|x|int|x-coordinate|y|int|y-coordinate|z|int|z-coordinate|conut|int|How many to spawn(1-64)|health|int|item health. 0 is max health, max value depends on the item|user|const char*|Username|void|Spawns an item at (x,y,z) with type,count and health specified. If "user" is set, he will not be able to pick up the item right away to make it possible to throw stuff away.}}

{{APIFunct1|setTime|timeValue|int|value between 0 and 2400|bool|Sets server time to ''timeValue''}}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''getSpawn'''
| class="col1" | x
| class="col2" | int*
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int*
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int*
| class="col3" | z-coordinate
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row5"
| class="col0" colspan="4" | Gets server spawn position
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''getBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Get block type and metadata (absolute block coordinates) in first world (id 0)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''getBlockW'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | w
| class="col2" | int
| class="col3" | World ID
|- class="row5"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row6"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row8"
| class="col0" colspan="4" | Gets block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''setBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Set block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''setBlockW'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | w
| class="col2" | int
| class="col3" | World ID
|- class="row5"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row6"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row8"
| class="col0" colspan="4" | Sets block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''setSpawn'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row5"
| class="col0" colspan="4" | Set spawn to x, y, z (absolute coordinates)
|}

{{APIFunctVoid|saveWholeMap| |void| |Saves the whole map to disk}}

{{APIFunct2|getMapData_block|x|int|x-coordinate|z|int|z-coordinate|unsigned char*| }}

{{APIFunct2|getMapData_meta|x|int|x-coordinate|z|int|z-coordinate|unsigned char*| }}

{{APIFunct2|getMapData_skylight|x|int|x-coordinate|z|int|z-coordinate|unsigned char*| }}

{{APIFunct2|getMapData_blocklight|x|int|x-coordinate|z|int|z-coordinate|unsigned char*| }}

====User Functions====

{{APIFunct1|toggleDND|user|const char*|Username in null terminated char array|bool, indicates if user was found|Toggles the DND (Do not Disturb)-Mode of a ''user''}}

{{APIFunct7|getPosition|user|const char*|Username in null terminated char array|x|double*|x-coordinate|y|double*|y-coordinate|z|double*|z-coordinate|yaw|float*|yaw-Value|pitch|float*|pitch-Value|*stance|double|stance-Value|bool, true if user has been found|Finds a player and stores its info in the referenced variables}}

{{APIFunct8|getPosition|user|const char*|Username in null terminated char array|x|double*|x-coordinate|y|double*|y-coordinate|z|double*|z-coordinate|w|int*|World ID|yaw|float*|yaw-Value|pitch|float*|pitch-Value| *stance|double|stance-Value|bool, true if user has been found|Finds a player and stores its info in the referenced variables}}

{{APIFunct4|teleport|user|const char*|Username in null terminated char array|x|double*|x-coordinate|y|double*|y-coordinate|z|double*|z-coordinate|bool, true if user was found|Teleports a ''user'' to ''x'',''y'',''z''}}

{{APIFunct5|teleport|user|const char*|Username in null terminated char array|x|double*|x-coordinate|y|double*|y-coordinate|z|double*|z-coordinate|map|int|Map ID|bool, true if user was found|Teleports a ''user'' to ''x'',''y'',''z'' on ''map''}}

{{APIFunct2|setHealth|user|const char*|Username in null terminated char array|userHealth|int|Health of ''user''. Must not be greater than 20.|bool, true if user is not null|Sets the health of a ''user''.}}

{{APIFunct1|getHealth|user|const char*|Username in null terminated char array|int, player's health|Gets the health of a ''user''}}

{{APIFunct1|no paramters| | |int, number of players online|Gets the number of players online}}

{{APIFunct4|getItemInHand|user|const char*|Username in null terminated char array|*type|int|Type of item|*meta|int|Health of item|*quant|int|quantity of item|bool, true if user was found|Gets the item in the hand of ''user''}}

{{APIFunct4|setItemInHand|user|const char*|Username in null terminated char array|type|int|Type of item|meta|int|Health of item|quant|int|quantity of item, must not be greater than 64|bool, true if user was found|Sets the item in the hand of ''user''}}

{{APIFunct4|addItem|user|const char*|Username in null terminated char array|type|int|Type of item|meta|int|Health of item|quant|int|quantity of item, must not be greater than 64|bool, true if user was found|Adds the ''item'' to the ''user'''s inventory}}

{{APIFunct4|hasItem|user|const char*|Username in null terminated char array|type|int|Type of item|meta|int|Health of item|quant|int|quantity of item, must not be greater than 64|bool, true if the item is in Users inventory. Chests are unchecked.|Checks if ''item'' is in ''user'''s inventory}}

{{APIFunct4|delItem|user|const char*|Username in null terminated char array|type|int|Type of item|meta|int|Health of item|quant|int|quantity of item, must not be greater than 64|bool, true if user was found|Delets the ''item'' ''quantity'' times from the ''user'''s inventory. Chests are untouched.}}

{{APIFunct1|kick|user|const char*|Username in null terminated char array|bool, true if user is found|Kicks ''user'' with standard reason "You have been kicked"}}

====Config wrapper functions====
{{APIFunct1|has|name|const char*|name of the config string|bool, true if config string was found|Checks if the config string ''name'' exists in the configuration file}}

{{APIFunct1|iData|name|const char*|name of the config string|int|Gets integer data from configuration string ''name''}}

{{APIFunct1|lData|name|const char*|name of the config string|int64_t|Gets long (int64_t) data from configuration string ''name''}}

{{APIFunct1|fData|name|const char*|name of the config string|float|Gets float data from configuration string ''name''}}

{{APIFunct1|dData|name|const char*|name of the config string|double|Gets double data from configuration string ''name''}}

{{APIFunct1|sData|name|const char*|name of the config string|const char*|Gets string (char*) data from configuration string ''name''}}

{{APIFunct1|bData|name|const char*|name of the config string|bool|Gets bool data from configuration string ''name''}}

====Mobs====

====Permissions====

{{APIFunct1|setAdmin|name|const char*|Username in null terminated char array|bool, true if user was found|Makes ''user'' to a server administrator, providing him with full permissions.}}

{{APIFunct1|setOp|name|const char*|Username in null terminated char array|bool, true if user was found|Makes ''user'' to a server Operator}}

{{APIFunct1|setMember|name|const char*|Username in null terminated char array|bool, true if user was found|Makes ''user'' to a regular member}}

{{APIFunct1|setGuest|name|const char*|Username in null terminated char array|bool, true if user was found|Makes ''user'' to a guest}}

{{APIFunct1|isAdmin|name|const char*|Username in null terminated char array|bool, true if user is admin|Checks, if ''user'' is a server administrator}}

{{APIFunct1|isOp|name|const char*|Username in null terminated char array|bool, true if user is operator|Checks, if ''user'' is a server Operator}}

{{APIFunct1|isMember|name|const char*|Username in null terminated char array|bool, true if user is member|Checks, if ''user'' is a regular member}}

{{APIFunct1|Guest|name|const char*|Username in null terminated char array|bool, true if user is guest|Checks, if ''user'' is a guest}}

==Available callbacks==

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer200'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 200ms timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer1000'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 1000ms (1s) timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer10000'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 10s timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''PlayerChatPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | timestamp
| class="col2" | size_t
| class="col3" | time of the message
|- class="row2"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row4"
| class="col0" colspan="4" | called on chat message processing, returning false will terminate the callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''PlayerChatCommand'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | command
| class="col2" | const char*
| class="col3" | command
|- class="row2"
| class="col1" | argc
| class="col2" | int
| class="col3" | argument count
|- class="row3"
| class="col1" | arguments
| class="col2" | const char**
| class="col3" | list of arguments
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row5"
| class="col0" colspan="4" | called when chat command is used
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''BlockPlacePre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int32_t
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int8_t
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int32_t
| class="col3" | z-coord
|- class="row5"
| class="col1" | block
| class="col2" | int16_t
| class="col3" | block type
|- class="row6"
| class="col1" | direction
| class="col2" | int8_t
| class="col3" | placement direction
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row8"
| class="col0" colspan="4" | called on block placement, returning false will prevent block placement and terminate callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''BlockBreakPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coord
|- class="row5"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row6"
| class="col0" colspan="4" | called on block break, returning false will prevent block breaking and terminate callback.
|}


ToDo:

    setHook("PlayerLoginPre", new Hook2&lt;bool,const char*,char***&gt;);
    setHook("PlayerLoginPost", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerNickPost", new Hook2&lt;bool,const char*,const char*&gt;);
    setHook("PlayerKickPost", new Hook2&lt;bool,const char*,const char*&gt;);
    setHook("PlayerQuitPost", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerChatPost", new Hook3&lt;bool,const char*,time_t,const char*&gt;);
    setHook("PlayerArmSwing", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerDamagePre", new Hook3&lt;bool,const char*,const char*,int&gt;);
    setHook("PlayerDamagePost", new Hook3&lt;bool,const char*,const char*,int&gt;);
    setHook("PlayerDisconnect", new Hook3&lt;bool,const char*,uint32,uint16&gt;);
    setHook("PlayerDiggingStarted", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("PlayerDigging", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("PlayerDiggingStopped", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockBreakPre", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockBreakPost", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockNeighbourBreak", new Hook7&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32&gt;);
    setHook("BlockPlacePre", new Hook5&lt;bool,const char*,sint32,sint8,sint32,sint16&gt;);
    setHook("BlockPlacePost", new Hook5&lt;bool,const char*,sint32,sint8,sint32,sint16&gt;);
    setHook("BlockNeighbourPlace", new Hook7&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32&gt;);
    setHook("BlockReplacePost", new Hook6&lt;bool,const char*,sint32,sint8,sint32,sint16,sint16&gt;);
    setHook("BlockNeighbourReplace", new Hook9&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32,sint16,sint16&gt;);</text>
    <sha1>ed71fc708354feccb4d321f22a3e4ea40c5f0f8f</sha1>
  </revision>
  <revision>
    <id>170</id>
    <parentid>169</parentid>
    <timestamp>2011-02-27T21:06:00Z</timestamp>
    <contributor>
      <username>Delirium</username>
      <id>18</id>
    </contributor>
    <comment>/* Creating a plugin */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="19918" xml:space="preserve">Mineserver uses a C-plugin API which is described in this page.

==Creating a plugin==

You will need to include &lt;code&gt;plugin_api.h&lt;/code&gt; to your project.

...write some more stuff here...

Example plugin structure:

&lt;pre&gt;&lt;nowiki&gt;
#include &lt;stdio.h&gt;
#include &lt;stdlib.h&gt;
#include &lt;time.h&gt;
#include &lt;string.h&gt;
#include &lt;cstdlib&gt;
#include &lt;iostream&gt;

#define MINESERVER_C_API
#include "../src/plugin_api.h"
#include "../src/logtype.h"

#define PLUGIN_VERSION 1.0
double pluginVersion = PLUGIN_VERSION;

#define PLUGIN_NAME "pressurplate"
const char* pluginName = PLUGIN_NAME;

const char* logSource = "plugin.screen";
mineserver_pointer_struct* mineserver;

 PLUGIN_API_EXPORT void CALLCONVERSION pressurplate_init(mineserver_pointer_struct* mineserver_temp)
{
  mineserver = mineserver_temp;

  if (mineserver-&gt;plugin.getPluginVersion(pluginName) &gt; 0)
  {
    mineserver-&gt;logger.log(LogType::LOG_INFO, logSource, "The " PLUGIN_NAME " plugin is already loaded");
    return;
  }

  mineserver-&gt;logger.log(LogType::LOG_INFO, logSource, "Loaded " PLUGIN_NAME);
  mineserver-&gt;plugin.setPluginVersion(pluginName, pluginVersion);

}


PLUGIN_API_EXPORT void CALLCONVERSION pressurplate_shutdown(void)
{
  if (mineserver-&gt;plugin.getPluginVersion(pluginName) &lt;= 0)
  {
    mineserver-&gt;logger.log(LogType::LOG_INFO, logSource, PLUGIN_NAME " is not loaded!");
    return;
  }
  mineserver-&gt;logger.log(LogType::LOG_INFO, logSource, PLUGIN_NAME " has been unloaded!");
}

&lt;/nowiki&gt;
&lt;/pre&gt;

==Available functions==

===Mineserver===

====Chat====

{{APIFunct2|sendmsgTo|user|const char*|Username in null Terminated char array|msg|const char*|Message in null terminated char array|bool, telling it the user was found|Sends a message to specified ''user''}}

{{APIFunct1|sendmsg|msg|const char*|Message in null terminated char array|bool, telling it the user was found|Sends a message to all players, except they are in DND mode}}

{{APIFunct1|sendUserList|user|const char*|User in null terminated char array|bool, telling it the user was found|Sends the playerlist to ''user''}}

====Screen====

{{APIFunctVoid|log|msg|const char*|Message in null terminated char array|Prints message to server window}}

====Map====

{{APIFunct6|createPickupSpawn|x|int|x-coordinate|y|int|y-coordinate|z|int|z-coordinate|conut|int|How many to spawn(1-64)|health|int|item health. 0 is max health, max value depends on the item|user|const char*|Username|void|Spawns an item at (x,y,z) with type,count and health specified. If "user" is set, he will not be able to pick up the item right away to make it possible to throw stuff away.}}

{{APIFunct1|setTime|timeValue|int|value between 0 and 2400|bool|Sets server time to ''timeValue''}}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''getSpawn'''
| class="col1" | x
| class="col2" | int*
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int*
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int*
| class="col3" | z-coordinate
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | void
|- class="row5"
| class="col0" colspan="4" | Gets server spawn position
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''getBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Get block type and metadata (absolute block coordinates) in first world (id 0)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''getBlockW'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | w
| class="col2" | int
| class="col3" | World ID
|- class="row5"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row6"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row8"
| class="col0" colspan="4" | Gets block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''setBlock'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | type
| class="col2" | unsigned char
| class="col3" | block type
|- class="row5"
| class="col1" | meta
| class="col2" | unsigned char
| class="col3" | block metadata
|- class="row6"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row7"
| class="col0" colspan="4" | Set block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''setBlockW'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
| class="col1" | w
| class="col2" | int
| class="col3" | World ID
|- class="row5"
| class="col1" | type
| class="col2" | unsigned char*
| class="col3" | block type
|- class="row6"
| class="col1" | meta
| class="col2" | unsigned char*
| class="col3" | block metadata
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row8"
| class="col0" colspan="4" | Sets block type and metadata (absolute block coordinates)
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Function
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="5" | '''setSpawn'''
| class="col1" | x
| class="col2" | int
| class="col3" | x-coordinate
|- class="row2"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coordinate
|- class="row3"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coordinate
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row5"
| class="col0" colspan="4" | Set spawn to x, y, z (absolute coordinates)
|}

{{APIFunctVoid|saveWholeMap| |void| |Saves the whole map to disk}}

{{APIFunct2|getMapData_block|x|int|x-coordinate|z|int|z-coordinate|unsigned char*| }}

{{APIFunct2|getMapData_meta|x|int|x-coordinate|z|int|z-coordinate|unsigned char*| }}

{{APIFunct2|getMapData_skylight|x|int|x-coordinate|z|int|z-coordinate|unsigned char*| }}

{{APIFunct2|getMapData_blocklight|x|int|x-coordinate|z|int|z-coordinate|unsigned char*| }}

====User Functions====

{{APIFunct1|toggleDND|user|const char*|Username in null terminated char array|bool, indicates if user was found|Toggles the DND (Do not Disturb)-Mode of a ''user''}}

{{APIFunct7|getPosition|user|const char*|Username in null terminated char array|x|double*|x-coordinate|y|double*|y-coordinate|z|double*|z-coordinate|yaw|float*|yaw-Value|pitch|float*|pitch-Value|*stance|double|stance-Value|bool, true if user has been found|Finds a player and stores its info in the referenced variables}}

{{APIFunct8|getPosition|user|const char*|Username in null terminated char array|x|double*|x-coordinate|y|double*|y-coordinate|z|double*|z-coordinate|w|int*|World ID|yaw|float*|yaw-Value|pitch|float*|pitch-Value| *stance|double|stance-Value|bool, true if user has been found|Finds a player and stores its info in the referenced variables}}

{{APIFunct4|teleport|user|const char*|Username in null terminated char array|x|double*|x-coordinate|y|double*|y-coordinate|z|double*|z-coordinate|bool, true if user was found|Teleports a ''user'' to ''x'',''y'',''z''}}

{{APIFunct5|teleport|user|const char*|Username in null terminated char array|x|double*|x-coordinate|y|double*|y-coordinate|z|double*|z-coordinate|map|int|Map ID|bool, true if user was found|Teleports a ''user'' to ''x'',''y'',''z'' on ''map''}}

{{APIFunct2|setHealth|user|const char*|Username in null terminated char array|userHealth|int|Health of ''user''. Must not be greater than 20.|bool, true if user is not null|Sets the health of a ''user''.}}

{{APIFunct1|getHealth|user|const char*|Username in null terminated char array|int, player's health|Gets the health of a ''user''}}

{{APIFunct1|no paramters| | |int, number of players online|Gets the number of players online}}

{{APIFunct4|getItemInHand|user|const char*|Username in null terminated char array|*type|int|Type of item|*meta|int|Health of item|*quant|int|quantity of item|bool, true if user was found|Gets the item in the hand of ''user''}}

{{APIFunct4|setItemInHand|user|const char*|Username in null terminated char array|type|int|Type of item|meta|int|Health of item|quant|int|quantity of item, must not be greater than 64|bool, true if user was found|Sets the item in the hand of ''user''}}

{{APIFunct4|addItem|user|const char*|Username in null terminated char array|type|int|Type of item|meta|int|Health of item|quant|int|quantity of item, must not be greater than 64|bool, true if user was found|Adds the ''item'' to the ''user'''s inventory}}

{{APIFunct4|hasItem|user|const char*|Username in null terminated char array|type|int|Type of item|meta|int|Health of item|quant|int|quantity of item, must not be greater than 64|bool, true if the item is in Users inventory. Chests are unchecked.|Checks if ''item'' is in ''user'''s inventory}}

{{APIFunct4|delItem|user|const char*|Username in null terminated char array|type|int|Type of item|meta|int|Health of item|quant|int|quantity of item, must not be greater than 64|bool, true if user was found|Delets the ''item'' ''quantity'' times from the ''user'''s inventory. Chests are untouched.}}

{{APIFunct1|kick|user|const char*|Username in null terminated char array|bool, true if user is found|Kicks ''user'' with standard reason "You have been kicked"}}

====Config wrapper functions====
{{APIFunct1|has|name|const char*|name of the config string|bool, true if config string was found|Checks if the config string ''name'' exists in the configuration file}}

{{APIFunct1|iData|name|const char*|name of the config string|int|Gets integer data from configuration string ''name''}}

{{APIFunct1|lData|name|const char*|name of the config string|int64_t|Gets long (int64_t) data from configuration string ''name''}}

{{APIFunct1|fData|name|const char*|name of the config string|float|Gets float data from configuration string ''name''}}

{{APIFunct1|dData|name|const char*|name of the config string|double|Gets double data from configuration string ''name''}}

{{APIFunct1|sData|name|const char*|name of the config string|const char*|Gets string (char*) data from configuration string ''name''}}

{{APIFunct1|bData|name|const char*|name of the config string|bool|Gets bool data from configuration string ''name''}}

====Mobs====

====Permissions====

{{APIFunct1|setAdmin|name|const char*|Username in null terminated char array|bool, true if user was found|Makes ''user'' to a server administrator, providing him with full permissions.}}

{{APIFunct1|setOp|name|const char*|Username in null terminated char array|bool, true if user was found|Makes ''user'' to a server Operator}}

{{APIFunct1|setMember|name|const char*|Username in null terminated char array|bool, true if user was found|Makes ''user'' to a regular member}}

{{APIFunct1|setGuest|name|const char*|Username in null terminated char array|bool, true if user was found|Makes ''user'' to a guest}}

{{APIFunct1|isAdmin|name|const char*|Username in null terminated char array|bool, true if user is admin|Checks, if ''user'' is a server administrator}}

{{APIFunct1|isOp|name|const char*|Username in null terminated char array|bool, true if user is operator|Checks, if ''user'' is a server Operator}}

{{APIFunct1|isMember|name|const char*|Username in null terminated char array|bool, true if user is member|Checks, if ''user'' is a regular member}}

{{APIFunct1|Guest|name|const char*|Username in null terminated char array|bool, true if user is guest|Checks, if ''user'' is a guest}}

==Available callbacks==

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer200'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 200ms timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer1000'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 1000ms (1s) timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="1" | '''Timer10000'''
| class="col1" | no params
| class="col2" | 
| class="col3" | 
|- class="row2"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool, isn't used
|- class="row3"
| class="col0" colspan="4" | 10s timer callback
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="3" | '''PlayerChatPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | timestamp
| class="col2" | size_t
| class="col3" | time of the message
|- class="row2"
| class="col1" | msg
| class="col2" | const char*
| class="col3" | Message in null terminated char array
|- class="row3"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row4"
| class="col0" colspan="4" | called on chat message processing, returning false will terminate the callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''PlayerChatCommand'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in null terminated char array
|- class="row2"
| class="col1" | command
| class="col2" | const char*
| class="col3" | command
|- class="row2"
| class="col1" | argc
| class="col2" | int
| class="col3" | argument count
|- class="row3"
| class="col1" | arguments
| class="col2" | const char**
| class="col3" | list of arguments
|- class="row4"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row5"
| class="col0" colspan="4" | called when chat command is used
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="6" | '''BlockPlacePre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int32_t
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int8_t
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int32_t
| class="col3" | z-coord
|- class="row5"
| class="col1" | block
| class="col2" | int16_t
| class="col3" | block type
|- class="row6"
| class="col1" | direction
| class="col2" | int8_t
| class="col3" | placement direction
|- class="row7"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row8"
| class="col0" colspan="4" | called on block placement, returning false will prevent block placement and terminate callback.
|}

{| class="wikitable"
|- class="row0"
! class="col0" | Name
! class="col1" | Parameter name
! class="col2" | Parameter type
! class="col3" | Parameter info
|- class="row1"
| class="col0" rowspan="4" | '''BlockBreakPre'''
| class="col1" | user
| class="col2" | const char*
| class="col3" | Username in char array
|- class="row2"
| class="col1" | x
| class="col2" | int
| class="col3" | x-coord
|- class="row3"
| class="col1" | y
| class="col2" | int
| class="col3" | y-coord
|- class="row4"
| class="col1" | z
| class="col2" | int
| class="col3" | z-coord
|- class="row5"
! class="col0" | Return value
| class="col1 rightalign" colspan="3" | bool
|- class="row6"
| class="col0" colspan="4" | called on block break, returning false will prevent block breaking and terminate callback.
|}


ToDo:

    setHook("PlayerLoginPre", new Hook2&lt;bool,const char*,char***&gt;);
    setHook("PlayerLoginPost", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerNickPost", new Hook2&lt;bool,const char*,const char*&gt;);
    setHook("PlayerKickPost", new Hook2&lt;bool,const char*,const char*&gt;);
    setHook("PlayerQuitPost", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerChatPost", new Hook3&lt;bool,const char*,time_t,const char*&gt;);
    setHook("PlayerArmSwing", new Hook1&lt;bool,const char*&gt;);
    setHook("PlayerDamagePre", new Hook3&lt;bool,const char*,const char*,int&gt;);
    setHook("PlayerDamagePost", new Hook3&lt;bool,const char*,const char*,int&gt;);
    setHook("PlayerDisconnect", new Hook3&lt;bool,const char*,uint32,uint16&gt;);
    setHook("PlayerDiggingStarted", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("PlayerDigging", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("PlayerDiggingStopped", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockBreakPre", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockBreakPost", new Hook4&lt;bool,const char*,sint32,sint8,sint32&gt;);
    setHook("BlockNeighbourBreak", new Hook7&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32&gt;);
    setHook("BlockPlacePre", new Hook5&lt;bool,const char*,sint32,sint8,sint32,sint16&gt;);
    setHook("BlockPlacePost", new Hook5&lt;bool,const char*,sint32,sint8,sint32,sint16&gt;);
    setHook("BlockNeighbourPlace", new Hook7&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32&gt;);
    setHook("BlockReplacePost", new Hook6&lt;bool,const char*,sint32,sint8,sint32,sint16,sint16&gt;);
    setHook("BlockNeighbourReplace", new Hook9&lt;bool,const char*,sint32,sint8,sint32,sint32,sint8,sint32,sint16,sint16&gt;);</text>
    <sha1>9566af2c0875ef6269f0666bfab509598475b20b</sha1>
  </revision>
</page>
<page arvcontinue="20110226223740|151">
  <title>Main Page</title>
  <ns>0</ns>
  <id>1</id>
  <revision>
    <id>171</id>
    <parentid>106</parentid>
    <timestamp>2011-02-27T23:14:22Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <minor/>
    <comment>ToDo link</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="661" xml:space="preserve">Hi there! Welcome to the Mineserver wiki. Below is a list of articles that may or may not need writing. This page will be fleshed out when we have some more content here.

If you feel like creating, fixing and/or adding anything, you can log in with your forum account. If you don't yet have a forum account, you can create one [http://mineserver.be/forums/ here]. This wiki will become publicly editable when there are a few more users and we have some spam/vandal control in place.

* [[Installation]]
* [[Configuration]]
* [[Commands]]
* [[Frequently Asked Questions]]
* [[Advanced Usage]]
* [[Coding Style]]
* [[Plugin API]]

* [[ToDo]]

----

* [[Plugins]]</text>
    <sha1>bf95ef78e6fcfb01e57d908b9698ae5159f29f43</sha1>
  </revision>
  <revision>
    <id>187</id>
    <parentid>171</parentid>
    <timestamp>2011-03-01T19:26:40Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="685" xml:space="preserve">Hi there! Welcome to the Mineserver wiki. Below is a list of articles that may or may not need writing. This page will be fleshed out when we have some more content here.

If you feel like creating, fixing and/or adding anything, you can log in with your forum account. If you don't yet have a forum account, you can create one [http://mineserver.be/forums/ here]. This wiki will become publicly editable when there are a few more users and we have some spam/vandal control in place.

* [[Installation]]
* [[Configuration]]
* [[Commands]] (needs command plugin!)
* [[Frequently Asked Questions]]
* [[Advanced Usage]]
* [[Coding Style]]
* [[Plugin API]]

* [[ToDo]]

----

* [[Plugins]]</text>
    <sha1>ca2c867a052e376eec37fcecfc4901fcb8559a3c</sha1>
  </revision>
</page>
<page arvcontinue="20110226223740|151">
  <title>ToDo</title>
  <ns>0</ns>
  <id>30</id>
  <revision>
    <id>172</id>
    <timestamp>2011-02-27T23:19:42Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <comment>Created page with "Things we need to do  Please help with formatting!  '''NOT IN ORDER!'''   == Features ==  * Redstone * Minecarts/boats * Projectile tracking (Can be thrown/shoot but server has n..."</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="389" xml:space="preserve">Things we need to do

Please help with formatting!

'''NOT IN ORDER!'''


== Features ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (Already PassiveMobs plugin!)

== Bugfixes ==

* Water/Lava working (currently water is flowing but buggy)

== Roadmap ==

To Do before version '''0.0.16''':
* Projectile Tracking</text>
    <sha1>1a91d3e511077980edbeebb804d995bc2bb5e9ea</sha1>
  </revision>
  <revision>
    <id>173</id>
    <parentid>172</parentid>
    <timestamp>2011-02-28T13:15:53Z</timestamp>
    <contributor>
      <username>Trigg</username>
      <id>19</id>
    </contributor>
    <comment>/* Features */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="445" xml:space="preserve">Things we need to do

Please help with formatting!

'''NOT IN ORDER!'''


== Features ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (Already PassiveMobs plugin!)
* Base Entity class and subclass other Entities from it

== Bugfixes ==

* Water/Lava working (currently water is flowing but buggy)

== Roadmap ==

To Do before version '''0.0.16''':
* Projectile Tracking</text>
    <sha1>0b9b41dba576f800aafdfb275bf8f860ce9ce1a3</sha1>
  </revision>
  <revision>
    <id>174</id>
    <parentid>173</parentid>
    <timestamp>2011-02-28T14:13:11Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="550" xml:space="preserve">Things we need to do

Please help with formatting!

'''NOT IN ORDER!'''


== Features ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)

== Bugfixes ==

* Water/Lava working (currently water is flowing but buggy)

== Roadmap ==

To Do before version '''0.0.16''':
* Projectile Tracking</text>
    <sha1>86656d31e53e1194f644c3c84f72fe5fcd9aa143</sha1>
  </revision>
  <revision>
    <id>175</id>
    <parentid>174</parentid>
    <timestamp>2011-02-28T15:46:05Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <comment>chunk related stuff</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="721" xml:space="preserve">Things we need to do

Please help with formatting!

'''NOT IN ORDER!'''


== Features ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* New chunk storage format
* Chunk loading/saving plugin API stuff

== Bugfixes ==

* Water/Lava working (currently water is flowing but buggy)
* Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.

== Roadmap ==

To Do before version '''0.0.16''':
* Projectile Tracking</text>
    <sha1>9fa8f49e8a8e90107bd3a05ea05f9e1537a377f7</sha1>
  </revision>
  <revision>
    <id>176</id>
    <parentid>175</parentid>
    <timestamp>2011-02-28T21:52:09Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <minor/>
    <comment>TNT \o/</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="728" xml:space="preserve">Things we need to do

Please help with formatting!

'''NOT IN ORDER!'''


== Features ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* New chunk storage format
* Chunk loading/saving plugin API stuff
* TNT


== Bugfixes ==

* Water/Lava working (currently water is flowing but buggy)
* Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.

== Roadmap ==

To Do before version '''0.0.16''':
* Projectile Tracking</text>
    <sha1>71569cd57327a094f5bf7252fdc4740927f98ed6</sha1>
  </revision>
  <revision>
    <id>177</id>
    <parentid>176</parentid>
    <timestamp>2011-02-28T23:11:59Z</timestamp>
    <contributor>
      <username>Jailout2000</username>
      <id>21</id>
    </contributor>
    <minor/>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="826" xml:space="preserve">Things we need to do

Please help with formatting!

Please note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* New chunk storage format
* Chunk loading/saving plugin API stuff
* TNT


== Bugfixes ==

* Water/Lava working (currently water is flowing but buggy)
* Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.

== Roadmap ==

To Do before version '''0.0.16''':
* Projectile Tracking</text>
    <sha1>3ecf09c30b5e2b6e05a47f162cd394aa3f4b31ad</sha1>
  </revision>
  <revision>
    <id>179</id>
    <parentid>177</parentid>
    <timestamp>2011-03-01T06:16:48Z</timestamp>
    <contributor>
      <username>Joehillen</username>
      <id>22</id>
    </contributor>
    <comment>Added link to the new format.</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="897" xml:space="preserve">Things we need to do

Please help with formatting!

Please note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT


== Bugfixes ==

* Water/Lava working (currently water is flowing but buggy)
* Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.

== Roadmap ==

To Do before version '''0.0.16''':
* Projectile Tracking</text>
    <sha1>7b20d7b22a49261bf265e060f8af80518de972c2</sha1>
  </revision>
  <revision>
    <id>188</id>
    <parentid>179</parentid>
    <timestamp>2011-03-01T19:36:39Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="891" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT


== Bugfixes ==

* Water/Lava working (currently water is flowing but buggy)
* Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.


== Roadmap ==

To Do before version '''0.0.16''':
* Projectile Tracking</text>
    <sha1>a4526488e714bb69fdc51f351f602ffe29aea568</sha1>
  </revision>
  <revision>
    <id>191</id>
    <parentid>188</parentid>
    <timestamp>2011-03-01T21:43:50Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="954" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT


== Bugfixes ==

* Water/Lava working (currently water is flowing but buggy)
* Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.
* Fix user spawn-handling (Currently causes invisible players)


== Roadmap ==

To Do before version '''0.0.16''':
* Projectile Tracking</text>
    <sha1>dfa1259f5c9b3447a2bfdef69b0a3e6d0be8f6b1</sha1>
  </revision>
  <revision>
    <id>192</id>
    <parentid>191</parentid>
    <timestamp>2011-03-01T21:47:07Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="969" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT
* Doublechests


== Bugfixes ==

* Water/Lava working (currently water is flowing but buggy)
* Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.
* Fix user spawn-handling (Currently causes invisible players)


== Roadmap ==

To Do before version '''0.0.16''':
* Projectile Tracking</text>
    <sha1>7afeff4e8dc8b8562f8a48d8f6fbb5a94a848af7</sha1>
  </revision>
  <revision>
    <id>193</id>
    <parentid>192</parentid>
    <timestamp>2011-03-01T21:49:10Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1032" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT
* Doublechests


== Bugfixes ==

* Water/Lava working (currently water is flowing but buggy)
* Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.
* Fix user spawn-handling (Currently causes invisible players)


== Roadmap ==

To Do before version '''0.0.16''':
* Projectile Tracking
* Fix user spawn-handling (Currently causes invisible players)</text>
    <sha1>05500c652dee083a4e467641bba0e386e7d3e62c</sha1>
  </revision>
  <revision>
    <id>194</id>
    <parentid>193</parentid>
    <timestamp>2011-03-01T21:49:47Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1052" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT
* Doublechests
* Dispensers
* Beds


== Bugfixes ==

* Water/Lava working (currently water is flowing but buggy)
* Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.
* Fix user spawn-handling (Currently causes invisible players)


== Roadmap ==

To Do before version '''0.0.16''':
* Projectile Tracking
* Fix user spawn-handling (Currently causes invisible players)</text>
    <sha1>7ea4dcfb3a57fe4ad150573c22b27c2d7e101efe</sha1>
  </revision>
  <revision>
    <id>195</id>
    <parentid>194</parentid>
    <timestamp>2011-03-02T02:46:05Z</timestamp>
    <contributor>
      <username>Winex</username>
      <id>23</id>
    </contributor>
    <minor/>
    <comment>/* Roadmap */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1082" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT
* Doublechests
* Dispensers
* Beds


== Bugfixes ==

* Water/Lava working (currently water is flowing but buggy)
* Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.
* Fix user spawn-handling (Currently causes invisible players)


== Roadmap ==

To Do before version '''0.0.16''':
* Projectile Tracking
* Fix user spawn-handling (Currently causes invisible players)
* Complete CMake build system</text>
    <sha1>67a525f052ec29024f973314b038a06248252325</sha1>
  </revision>
  <revision>
    <id>197</id>
    <parentid>195</parentid>
    <timestamp>2011-03-02T09:11:33Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <comment>/* Bugfixes */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1094" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT
* Doublechests
* Dispensers
* Beds


== Bugfixes ==

* Water/Lava working (currently water is flowing but buggy)
* ['''DONE'''] Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.
* Fix user spawn-handling (Currently causes invisible players)

== Roadmap ==

To Do before version '''0.0.16''':
* Projectile Tracking
* Fix user spawn-handling (Currently causes invisible players)
* Complete CMake build system</text>
    <sha1>a5cc48bc1b03c40c2cf699cda7760837c86bbc7d</sha1>
  </revision>
  <revision>
    <id>198</id>
    <parentid>197</parentid>
    <timestamp>2011-03-02T09:17:47Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1116" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT
* Doublechests
* Dispensers
* Beds


== Bugfixes ==

* Water/Lava working (currently water is flowing but buggy)
* ['''DONE'''] Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.
* Fix user spawn-handling (Currently causes invisible players)

== Roadmap ==

To Do before version '''0.0.16''':
* McRegion fileformat
* Projectile Tracking
* Fix user spawn-handling (Currently causes invisible players)
* Complete CMake build system</text>
    <sha1>a3bd3f02b3a1ec55e6a0fe74f35c7e7bd2519d90</sha1>
  </revision>
  <revision>
    <id>199</id>
    <parentid>198</parentid>
    <timestamp>2011-03-02T09:18:57Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1157" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT
* Doublechests
* Dispensers
* Beds


== Bugfixes ==

* Water/Lava working (currently water is flowing but buggy)
* ['''DONE'''] Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.
* Fix user spawn-handling (Currently causes invisible players)

== Roadmap ==

To Do before version '''0.0.16''':
* New chunk storage format
* Projectile Tracking
* Fix user spawn-handling (Currently causes invisible players)
* Complete CMake build system

To Do before version '''0.0.17''':</text>
    <sha1>1b89eeacf37d74bd50cd9419f3c862a411d6a5de</sha1>
  </revision>
  <revision>
    <id>200</id>
    <parentid>199</parentid>
    <timestamp>2011-03-02T09:20:05Z</timestamp>
    <contributor>
      <username>Winex</username>
      <id>23</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1170" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT
* Doublechests
* Dispensers
* Beds


== Bugfixes ==

* Water/Lava working (currently water is flowing but buggy)
* ['''DONE'''] Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.
* Fix user spawn-handling (Currently causes invisible players)

== Roadmap ==

To Do before version '''0.0.16''':
* Support MCRegion world storage format
* Projectile Tracking
* Fix user spawn-handling (Currently causes invisible players)
* Complete CMake build system

To Do before version '''0.0.17''':</text>
    <sha1>5a3c37d12e807714c5f8e970f0e48f2add77eded</sha1>
  </revision>
</page>
<page arvcontinue="20110226223740|151">
  <title>Moving over from official server</title>
  <ns>0</ns>
  <id>24</id>
  <revision>
    <id>178</id>
    <parentid>144</parentid>
    <timestamp>2011-02-28T23:15:57Z</timestamp>
    <contributor>
      <username>Jailout2000</username>
      <id>21</id>
    </contributor>
    <minor/>
    <comment>fixed typos, etc.</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="863" xml:space="preserve">If you have already a working Minecraft server, but want to use Mineserver, you can easily move over!

==Preparation==
First of all, make a backup of your whole Minecraft server. If anything went differently from your expectations, this will allow you to go back.
Second, make sure your Minecraft world is in "old" Beta 1.2 File format. As of 26 Feb. 2011, Mineserver does not support the new Beta 1.3 File format. Beta 1.3 clients can connect though.

==Do the work==
[[Installation|Install]] Mineserver in a directory on your server. Edit the settings file to fit your needs, copy your world to the desired path and make sure the path is correctly specified in the settings. That's it! You can start Mineserver and start playing.

==What about plugins?==
At the moment, there are not many [[plugins]]. But you can write your own - just check the [[Plugin API]].</text>
    <sha1>a968adb6acb7b2034672fd801b296ca0fd923d28</sha1>
  </revision>
</page>
<page arvcontinue="20110226223740|151">
  <title>Installation</title>
  <ns>0</ns>
  <id>3</id>
  <revision>
    <id>180</id>
    <parentid>125</parentid>
    <timestamp>2011-03-01T19:08:43Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <comment>/* Prerequisites */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="9338" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise (possibly from [https://github.com/qknight/libnoise https://github.com/qknight/libnoise]). The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

Download the latest zip file from mineserver.be/downloads and make a new folder on your desktop, and name it whatever you want
Extract the files from the zip into that folder and edit the configuration, make sure your name is on the roles.txt list for you to be admin
Goto ahead and run the mineserver bat file and the server will start

To get your ip address, goto www.cmyip.com

Edited by liamallan 

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

Most dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

However CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  sudo cp -R include /usr/local/include/noise
  sudo cp lib/* /usr/local/lib
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

You also have to copy the contents of the src folder of the libnoise package into a folder called libnoise within the mineserver src directory:

  change directory to your mineserver src directory
  mkdir libnoise
  cp -R /path/to/libnoise/src/* ./
  make

:)

====BSD Variants====
Due to a problem with the libnoise package, you may need to create the proper link for the libnoise shared object file:

  ln -s /usr/local/lib/libnoise.so.0 /usr/local/lib/libnoise.so

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====

To install third party libraries on OS X, some convenient ways exist.
Note that zlib ships with OS X by default.

===== MacPorts or Fink =====

You can install zlib and libevent using Macports:

 sudo port install libevent

or Fink:

 sudo apt-get install libevent1

Either way, you will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

or Fink:

 sudo apt-get install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===== Homebrew =====

With homebrew installed, you can just install libevent:

 brew install libevent

A formular for libnoise can be found on [http://github.com/krono/homebrew krono’s homebrew fork].
Using that, you can install libnoise just the same way:

 brew install libnoise

It does not depend on cmake and doxygen.

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that below.

'''NOTE'''! If you are using debian/ubuntu or similar use &lt;code&gt;make DEBIAN=1&lt;/code&gt; instead of &lt;code&gt;make&lt;/code&gt;

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

===== Macports =====

You can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

  cd src
  CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===== Fink =====

You can build, ensuring that you point the compiler to any Fink-installed headers and libraries:

  cd src
  CXXFLAGS=-I/sw/include LDFLAGS=-L/sw/lib make


===== Homebrew =====

Homebrew installs in a System-Known location, so you just have to make.
  cd src
  make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>b4b21663e728574b875b325de61ac95eea6540fe</sha1>
  </revision>
  <revision>
    <id>181</id>
    <parentid>180</parentid>
    <timestamp>2011-03-01T19:11:05Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <comment>/* Windows */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="9044" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise (possibly from [https://github.com/qknight/libnoise https://github.com/qknight/libnoise]). The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

Prerequisites can be found at http://www.mineserver.be/downloads buildpack or you can compile those yourself

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

Most dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

However CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  sudo cp -R include /usr/local/include/noise
  sudo cp lib/* /usr/local/lib
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

You also have to copy the contents of the src folder of the libnoise package into a folder called libnoise within the mineserver src directory:

  change directory to your mineserver src directory
  mkdir libnoise
  cp -R /path/to/libnoise/src/* ./
  make

:)

====BSD Variants====
Due to a problem with the libnoise package, you may need to create the proper link for the libnoise shared object file:

  ln -s /usr/local/lib/libnoise.so.0 /usr/local/lib/libnoise.so

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====

To install third party libraries on OS X, some convenient ways exist.
Note that zlib ships with OS X by default.

===== MacPorts or Fink =====

You can install zlib and libevent using Macports:

 sudo port install libevent

or Fink:

 sudo apt-get install libevent1

Either way, you will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

or Fink:

 sudo apt-get install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===== Homebrew =====

With homebrew installed, you can just install libevent:

 brew install libevent

A formular for libnoise can be found on [http://github.com/krono/homebrew krono’s homebrew fork].
Using that, you can install libnoise just the same way:

 brew install libnoise

It does not depend on cmake and doxygen.

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that below.

'''NOTE'''! If you are using debian/ubuntu or similar use &lt;code&gt;make DEBIAN=1&lt;/code&gt; instead of &lt;code&gt;make&lt;/code&gt;

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

===== Macports =====

You can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

  cd src
  CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===== Fink =====

You can build, ensuring that you point the compiler to any Fink-installed headers and libraries:

  cd src
  CXXFLAGS=-I/sw/include LDFLAGS=-L/sw/lib make


===== Homebrew =====

Homebrew installs in a System-Known location, so you just have to make.
  cd src
  make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>a3c77d6b397a44124c1a66422b7d15922ee1bf33</sha1>
  </revision>
  <revision>
    <id>182</id>
    <parentid>181</parentid>
    <timestamp>2011-03-01T19:12:00Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <comment>/* Windows */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="9099" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise (possibly from [https://github.com/qknight/libnoise https://github.com/qknight/libnoise]). The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

Prerequisites can be found at http://www.mineserver.be/downloads buildpack or you can compile those yourself. For that you will need VS2010 or mingw (no supported)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

Most dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

However CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  sudo cp -R include /usr/local/include/noise
  sudo cp lib/* /usr/local/lib
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

You also have to copy the contents of the src folder of the libnoise package into a folder called libnoise within the mineserver src directory:

  change directory to your mineserver src directory
  mkdir libnoise
  cp -R /path/to/libnoise/src/* ./
  make

:)

====BSD Variants====
Due to a problem with the libnoise package, you may need to create the proper link for the libnoise shared object file:

  ln -s /usr/local/lib/libnoise.so.0 /usr/local/lib/libnoise.so

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====

To install third party libraries on OS X, some convenient ways exist.
Note that zlib ships with OS X by default.

===== MacPorts or Fink =====

You can install zlib and libevent using Macports:

 sudo port install libevent

or Fink:

 sudo apt-get install libevent1

Either way, you will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

or Fink:

 sudo apt-get install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===== Homebrew =====

With homebrew installed, you can just install libevent:

 brew install libevent

A formular for libnoise can be found on [http://github.com/krono/homebrew krono’s homebrew fork].
Using that, you can install libnoise just the same way:

 brew install libnoise

It does not depend on cmake and doxygen.

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that below.

'''NOTE'''! If you are using debian/ubuntu or similar use &lt;code&gt;make DEBIAN=1&lt;/code&gt; instead of &lt;code&gt;make&lt;/code&gt;

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

===== Macports =====

You can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

  cd src
  CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===== Fink =====

You can build, ensuring that you point the compiler to any Fink-installed headers and libraries:

  cd src
  CXXFLAGS=-I/sw/include LDFLAGS=-L/sw/lib make


===== Homebrew =====

Homebrew installs in a System-Known location, so you just have to make.
  cd src
  make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>a07281b686ebac6917f41a424698b759fb7bf0a9</sha1>
  </revision>
  <revision>
    <id>183</id>
    <parentid>182</parentid>
    <timestamp>2011-03-01T19:12:17Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <comment>/* CentOS and Red Hat */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="9095" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise (possibly from [https://github.com/qknight/libnoise https://github.com/qknight/libnoise]). The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

Prerequisites can be found at http://www.mineserver.be/downloads buildpack or you can compile those yourself. For that you will need VS2010 or mingw (no supported)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

Most dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

However CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  sudo cp -R include /usr/local/include/noise
  sudo cp lib/* /usr/local/lib
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

You also have to copy the contents of the src folder of the libnoise package into a folder called libnoise within the mineserver src directory:

  change directory to your mineserver src directory
  mkdir libnoise
  cp -R /path/to/libnoise/src/* ./
  make

====BSD Variants====
Due to a problem with the libnoise package, you may need to create the proper link for the libnoise shared object file:

  ln -s /usr/local/lib/libnoise.so.0 /usr/local/lib/libnoise.so

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====

To install third party libraries on OS X, some convenient ways exist.
Note that zlib ships with OS X by default.

===== MacPorts or Fink =====

You can install zlib and libevent using Macports:

 sudo port install libevent

or Fink:

 sudo apt-get install libevent1

Either way, you will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

or Fink:

 sudo apt-get install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===== Homebrew =====

With homebrew installed, you can just install libevent:

 brew install libevent

A formular for libnoise can be found on [http://github.com/krono/homebrew krono’s homebrew fork].
Using that, you can install libnoise just the same way:

 brew install libnoise

It does not depend on cmake and doxygen.

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that below.

'''NOTE'''! If you are using debian/ubuntu or similar use &lt;code&gt;make DEBIAN=1&lt;/code&gt; instead of &lt;code&gt;make&lt;/code&gt;

  # Change to the source directory
  user@workstation:~/mineserver$ cd src
  # Run make to build the binary
  user@workstation:~/mineserver/src$ make
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mineserver.o mineserver.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o map.o map.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o chat.o chat.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o commands.o commands.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o config.o config.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o constants.o constants.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o logger.o logger.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mapgen.o mapgen.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o nbt.o nbt.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o packets.o packets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o physics.o physics.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o sockets.o sockets.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o tools.o tools.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o user.o user.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o noiseutils.o noiseutils.cpp
  g++  -I. -I/usr/Local/include -I/usr/include -L/usr/local/lib   -c -o mersenne.o mersenne.cpp
  g++ -L/usr/local/lib -L/usr/lib -lpthread -levent -lz -lnoise  mineserver.o map.o chat.o commands.o
  config.o constants.o logger.o mapgen.o nbt.o packets.o physics.o sockets.o tools.o user.o
  noiseutils.o mersenne.o   -o mineserver
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

===== Macports =====

You can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

  cd src
  CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===== Fink =====

You can build, ensuring that you point the compiler to any Fink-installed headers and libraries:

  cd src
  CXXFLAGS=-I/sw/include LDFLAGS=-L/sw/lib make


===== Homebrew =====

Homebrew installs in a System-Known location, so you just have to make.
  cd src
  make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>ffaac35d04058240c55b56167bc1f66b460244e5</sha1>
  </revision>
  <revision>
    <id>184</id>
    <parentid>183</parentid>
    <timestamp>2011-03-01T19:15:18Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <comment>/* GNU/Linux */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="7403" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise (possibly from [https://github.com/qknight/libnoise https://github.com/qknight/libnoise]). The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

Prerequisites can be found at http://www.mineserver.be/downloads buildpack or you can compile those yourself. For that you will need VS2010 or mingw (no supported)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

Most dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

However CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  sudo cp -R include /usr/local/include/noise
  sudo cp lib/* /usr/local/lib
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

You also have to copy the contents of the src folder of the libnoise package into a folder called libnoise within the mineserver src directory:

  change directory to your mineserver src directory
  mkdir libnoise
  cp -R /path/to/libnoise/src/* ./
  make

====BSD Variants====
Due to a problem with the libnoise package, you may need to create the proper link for the libnoise shared object file:

  ln -s /usr/local/lib/libnoise.so.0 /usr/local/lib/libnoise.so

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====

To install third party libraries on OS X, some convenient ways exist.
Note that zlib ships with OS X by default.

===== MacPorts or Fink =====

You can install zlib and libevent using Macports:

 sudo port install libevent

or Fink:

 sudo apt-get install libevent1

Either way, you will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

or Fink:

 sudo apt-get install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===== Homebrew =====

With homebrew installed, you can just install libevent:

 brew install libevent

A formular for libnoise can be found on [http://github.com/krono/homebrew krono’s homebrew fork].
Using that, you can install libnoise just the same way:

 brew install libnoise

It does not depend on cmake and doxygen.

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that below.

'''NOTE'''! If make fails to find libnoise try &lt;code&gt;make DEBIAN=1&lt;/code&gt; instead of &lt;code&gt;make&lt;/code&gt;

  # Run cmake to generate makefile
  user@workstation:~/mineserver$ cmake .
  # Run make all to build the binary
  user@workstation:~/mineserver/src$ make all
  (Lots of compile output here)
  # Done!
  user@workstation:~/mineserver/src$

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

===== Macports =====

You can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

  cd src
  CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===== Fink =====

You can build, ensuring that you point the compiler to any Fink-installed headers and libraries:

  cd src
  CXXFLAGS=-I/sw/include LDFLAGS=-L/sw/lib make


===== Homebrew =====

Homebrew installs in a System-Known location, so you just have to make.
  cd src
  make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>dc19d69120466bb11de9f717bcb40a2aca34b678</sha1>
  </revision>
  <revision>
    <id>185</id>
    <parentid>184</parentid>
    <timestamp>2011-03-01T19:16:39Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <comment>/* GNU/Linux */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="7498" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise (possibly from [https://github.com/qknight/libnoise https://github.com/qknight/libnoise]). The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

Prerequisites can be found at http://www.mineserver.be/downloads buildpack or you can compile those yourself. For that you will need VS2010 or mingw (no supported)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

Most dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

However CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  sudo cp -R include /usr/local/include/noise
  sudo cp lib/* /usr/local/lib
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

You also have to copy the contents of the src folder of the libnoise package into a folder called libnoise within the mineserver src directory:

  change directory to your mineserver src directory
  mkdir libnoise
  cp -R /path/to/libnoise/src/* ./
  make

====BSD Variants====
Due to a problem with the libnoise package, you may need to create the proper link for the libnoise shared object file:

  ln -s /usr/local/lib/libnoise.so.0 /usr/local/lib/libnoise.so

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====

To install third party libraries on OS X, some convenient ways exist.
Note that zlib ships with OS X by default.

===== MacPorts or Fink =====

You can install zlib and libevent using Macports:

 sudo port install libevent

or Fink:

 sudo apt-get install libevent1

Either way, you will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

or Fink:

 sudo apt-get install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===== Homebrew =====

With homebrew installed, you can just install libevent:

 brew install libevent

A formular for libnoise can be found on [http://github.com/krono/homebrew krono’s homebrew fork].
Using that, you can install libnoise just the same way:

 brew install libnoise

It does not depend on cmake and doxygen.

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that below.

'''NOTE'''! If make fails to find libnoise try &lt;code&gt;make DEBIAN=1&lt;/code&gt; instead of &lt;code&gt;make&lt;/code&gt;

  # Run cmake to generate makefile
  user@workstation:~/mineserver$ cmake .
  # Run make all to build the binary
  user@workstation:~/mineserver/src$ make all
  (Lots of compile output here)
  # Done!
  # Run make install to move all necessary files to bin
  user@workstation:~/mineserver/src$ make install

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux (This might be outdated?)=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

===== Macports =====

You can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

  cd src
  CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===== Fink =====

You can build, ensuring that you point the compiler to any Fink-installed headers and libraries:

  cd src
  CXXFLAGS=-I/sw/include LDFLAGS=-L/sw/lib make


===== Homebrew =====

Homebrew installs in a System-Known location, so you just have to make.
  cd src
  make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>dee35f5d227551d7547a37e5f3cdd5f24225d358</sha1>
  </revision>
  <revision>
    <id>196</id>
    <parentid>185</parentid>
    <timestamp>2011-03-02T03:29:45Z</timestamp>
    <contributor>
      <username>Winex</username>
      <id>23</id>
    </contributor>
    <minor/>
    <comment>/* GNU/Linux */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="7394" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise (possibly from [https://github.com/qknight/libnoise https://github.com/qknight/libnoise]). The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

Prerequisites can be found at http://www.mineserver.be/downloads buildpack or you can compile those yourself. For that you will need VS2010 or mingw (no supported)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

Most dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

However CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  sudo cp -R include /usr/local/include/noise
  sudo cp lib/* /usr/local/lib
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

You also have to copy the contents of the src folder of the libnoise package into a folder called libnoise within the mineserver src directory:

  change directory to your mineserver src directory
  mkdir libnoise
  cp -R /path/to/libnoise/src/* ./
  make

====BSD Variants====
Due to a problem with the libnoise package, you may need to create the proper link for the libnoise shared object file:

  ln -s /usr/local/lib/libnoise.so.0 /usr/local/lib/libnoise.so

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====

To install third party libraries on OS X, some convenient ways exist.
Note that zlib ships with OS X by default.

===== MacPorts or Fink =====

You can install zlib and libevent using Macports:

 sudo port install libevent

or Fink:

 sudo apt-get install libevent1

Either way, you will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

or Fink:

 sudo apt-get install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===== Homebrew =====

With homebrew installed, you can just install libevent:

 brew install libevent

A formular for libnoise can be found on [http://github.com/krono/homebrew krono’s homebrew fork].
Using that, you can install libnoise just the same way:

 brew install libnoise

It does not depend on cmake and doxygen.

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that below.

  # Run cmake to generate makefile
  user@workstation:~/mineserver$ cmake .
  # Run make all to build the binary
  user@workstation:~/mineserver/src$ make all
  (Lots of compile output here)
  # Done!
  # Run make install to move all necessary files to bin
  user@workstation:~/mineserver/src$ make install

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux (This might be outdated?)=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

===== Macports =====

You can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

  cd src
  CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===== Fink =====

You can build, ensuring that you point the compiler to any Fink-installed headers and libraries:

  cd src
  CXXFLAGS=-I/sw/include LDFLAGS=-L/sw/lib make


===== Homebrew =====

Homebrew installs in a System-Known location, so you just have to make.
  cd src
  make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.</text>
    <sha1>144cc994211a0cd3ff0de980d7d5a81ace147818</sha1>
  </revision>
</page>
<page arvcontinue="20110226223740|151">
  <title>Configuration</title>
  <ns>0</ns>
  <id>2</id>
  <revision>
    <id>186</id>
    <parentid>109</parentid>
    <timestamp>2011-03-01T19:17:35Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="245" xml:space="preserve">* Latest configuration file with explanations can be found here: https://github.com/fador/mineserver/blob/master/files/config.cfg
* Configurable item aliases can be found here: https://github.com/fador/mineserver/blob/master/files/item_alias.cfg</text>
    <sha1>5260019132c6ee8a3a01c388f2990bd3a9c2953a</sha1>
  </revision>
</page>
<page arvcontinue="20110302092053|201">
  <title>ToDo</title>
  <ns>0</ns>
  <id>30</id>
  <revision>
    <id>201</id>
    <parentid>200</parentid>
    <timestamp>2011-03-02T09:20:53Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1170" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT
* Doublechests
* Dispensers
* Beds


== Bugfixes ==

* Water/Lava working (currently water is flowing but buggy)
* ['''DONE'''] Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.
* Fix user spawn-handling (Currently causes invisible players)

== Roadmap ==

To Do before version '''0.1.16''':
* Support MCRegion world storage format
* Projectile Tracking
* Fix user spawn-handling (Currently causes invisible players)
* Complete CMake build system

To Do before version '''0.1.17''':</text>
    <sha1>8589e95b56504c0db6b7cb90ce5e0ea38d673e02</sha1>
  </revision>
  <revision>
    <id>202</id>
    <parentid>201</parentid>
    <timestamp>2011-03-02T09:23:08Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1178" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features TODO ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT
* Doublechests
* Dispensers
* Beds


== Bugs to fix ==

* Water/Lava working (currently water is flowing but buggy)
* ['''DONE'''] Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.
* Fix user spawn-handling (Currently causes invisible players)

== Roadmap ==

To Do before version '''0.1.16''':
* Support MCRegion world storage format
* Projectile Tracking
* Fix user spawn-handling (Currently causes invisible players)
* Complete CMake build system

To Do before version '''0.1.17''':</text>
    <sha1>53a7147f11f53195c710ab9462e9355ecf902550</sha1>
  </revision>
  <revision>
    <id>203</id>
    <parentid>202</parentid>
    <timestamp>2011-03-02T09:23:28Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1179" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features TODO ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT
* Doublechests
* Dispensers
* Beds


== Bugs to fix ==

* Water/Lava working (currently water is flowing but buggy)
* ['''DONE'''] Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.
* Fix user spawn-handling (Currently causes invisible players)


== Roadmap ==

To Do before version '''0.1.16''':
* Support MCRegion world storage format
* Projectile Tracking
* Fix user spawn-handling (Currently causes invisible players)
* Complete CMake build system

To Do before version '''0.1.17''':</text>
    <sha1>924bfdd4e1a72a80c438b3b66258ff56310964a9</sha1>
  </revision>
  <revision>
    <id>204</id>
    <parentid>203</parentid>
    <timestamp>2011-03-02T09:23:45Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1179" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ToDo ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT
* Doublechests
* Dispensers
* Beds


== Bugs to fix ==

* Water/Lava working (currently water is flowing but buggy)
* ['''DONE'''] Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.
* Fix user spawn-handling (Currently causes invisible players)


== Roadmap ==

To Do before version '''0.1.16''':
* Support MCRegion world storage format
* Projectile Tracking
* Fix user spawn-handling (Currently causes invisible players)
* Complete CMake build system

To Do before version '''0.1.17''':</text>
    <sha1>63f35251d1f5b72f9917433e9d27b20bf9b64050</sha1>
  </revision>
  <revision>
    <id>205</id>
    <parentid>204</parentid>
    <timestamp>2011-03-02T09:25:54Z</timestamp>
    <contributor>
      <username>Nredor</username>
      <id>10</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1218" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ToDo ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT
* Doublechests
* Dispensers
* Beds


== Bugs to fix ==

* Water/Lava working (currently water is flowing but buggy)
* ['''DONE'''] Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.
* Fix user spawn-handling (Currently causes invisible players)


== Roadmap ==

To Do before version '''0.1.16''':
* Support MCRegion world storage format
* Projectile Tracking
* Fix user spawn-handling (Currently causes invisible players)
* Complete CMake build system

To Do before version '''0.1.17''':
* Working water/lava
* Aggressive mobs</text>
    <sha1>d6eebf22602ca4d5f07472eb25ba9e29f877ceba</sha1>
  </revision>
  <revision>
    <id>206</id>
    <parentid>205</parentid>
    <timestamp>2011-03-07T15:52:43Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <minor/>
    <comment>/* Features ToDo */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1224" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ToDo ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT
* Doublechests
* Dispensers
* Beds
* Fire

== Bugs to fix ==

* Water/Lava working (currently water is flowing but buggy)
* ['''DONE'''] Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.
* Fix user spawn-handling (Currently causes invisible players)


== Roadmap ==

To Do before version '''0.1.16''':
* Support MCRegion world storage format
* Projectile Tracking
* Fix user spawn-handling (Currently causes invisible players)
* Complete CMake build system

To Do before version '''0.1.17''':
* Working water/lava
* Aggressive mobs</text>
    <sha1>339e3227f74e81e8990287ade21e8b2c3de5369c</sha1>
  </revision>
  <revision>
    <id>207</id>
    <parentid>206</parentid>
    <timestamp>2011-03-08T02:57:28Z</timestamp>
    <contributor>
      <username>Thorn</username>
      <id>24</id>
    </contributor>
    <comment>/* Bugs to fix */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1432" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ToDo ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT
* Doublechests
* Dispensers
* Beds
* Fire

== Bugs to fix ==

* Water/Lava working (currently water is flowing but buggy)
* ['''DONE'''] Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.
* Fix user spawn-handling (Currently causes invisible players)
* Trees spawning in air/water/sand
* Trees forming leaves on only one side
* Ctrl-C in ncurses console trashes terminal
* No red fog in nether
* Destroying sand(any falling block?) destroys stone block below.

== Roadmap ==

To Do before version '''0.1.16''':
* Support MCRegion world storage format
* Projectile Tracking
* Fix user spawn-handling (Currently causes invisible players)
* Complete CMake build system

To Do before version '''0.1.17''':
* Working water/lava
* Aggressive mobs</text>
    <sha1>2acbe445678cb946495f08408139427bce02b9f3</sha1>
  </revision>
  <revision>
    <id>209</id>
    <parentid>207</parentid>
    <timestamp>2011-03-10T19:58:29Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <comment>/* Roadmap */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1445" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ToDo ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT
* Doublechests
* Dispensers
* Beds
* Fire

== Bugs to fix ==

* Water/Lava working (currently water is flowing but buggy)
* ['''DONE'''] Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.
* Fix user spawn-handling (Currently causes invisible players)
* Trees spawning in air/water/sand
* Trees forming leaves on only one side
* Ctrl-C in ncurses console trashes terminal
* No red fog in nether
* Destroying sand(any falling block?) destroys stone block below.

== Roadmap ==

To Do before version '''0.1.16''':
* ['''DONE'''] Support MCRegion world storage format
* Projectile Tracking
* Fix user spawn-handling (Currently causes invisible players)
* Complete CMake build system

To Do before version '''0.1.17''':
* Working water/lava
* Aggressive mobs</text>
    <sha1>c2b51dec186470ba4cccc7c515a5e0ea47f79b77</sha1>
  </revision>
  <revision>
    <id>210</id>
    <parentid>209</parentid>
    <timestamp>2011-03-10T19:58:40Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <comment>/* Features ToDo */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1458" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ToDo ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* ['''DONE'''] [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT
* Doublechests
* Dispensers
* Beds
* Fire

== Bugs to fix ==

* Water/Lava working (currently water is flowing but buggy)
* ['''DONE'''] Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.
* Fix user spawn-handling (Currently causes invisible players)
* Trees spawning in air/water/sand
* Trees forming leaves on only one side
* Ctrl-C in ncurses console trashes terminal
* No red fog in nether
* Destroying sand(any falling block?) destroys stone block below.

== Roadmap ==

To Do before version '''0.1.16''':
* ['''DONE'''] Support MCRegion world storage format
* Projectile Tracking
* Fix user spawn-handling (Currently causes invisible players)
* Complete CMake build system

To Do before version '''0.1.17''':
* Working water/lava
* Aggressive mobs</text>
    <sha1>32fcf9b4b7ca48bf13fc278f5d1f210f6b3e36ed</sha1>
  </revision>
  <revision>
    <id>212</id>
    <parentid>210</parentid>
    <timestamp>2011-03-11T11:37:06Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <comment>/* Roadmap */ Build system should now affect version numbering</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1428" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ToDo ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* ['''DONE'''] [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT
* Doublechests
* Dispensers
* Beds
* Fire

== Bugs to fix ==

* Water/Lava working (currently water is flowing but buggy)
* ['''DONE'''] Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.
* Fix user spawn-handling (Currently causes invisible players)
* Trees spawning in air/water/sand
* Trees forming leaves on only one side
* Ctrl-C in ncurses console trashes terminal
* No red fog in nether
* Destroying sand(any falling block?) destroys stone block below.

== Roadmap ==

To Do before version '''0.1.16''':
* ['''DONE'''] Support MCRegion world storage format
* Projectile Tracking
* Fix user spawn-handling (Currently causes invisible players)

To Do before version '''0.1.17''':
* Working water/lava
* Aggressive mobs</text>
    <sha1>b404c69a4f5bf43c1c4599223074f42d7b366ede</sha1>
  </revision>
  <revision>
    <id>213</id>
    <parentid>212</parentid>
    <timestamp>2011-03-11T11:44:37Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <minor/>
    <comment>/* Bugs to fix */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1527" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ToDo ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* ['''DONE'''] [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT
* Doublechests
* Dispensers
* Beds
* Fire

== Bugs to fix ==

* Water/Lava working (currently water is flowing but buggy)
* ['''DONE'''] Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.
* Fix user spawn-handling (Currently causes invisible players)
* Trees spawning in air/water/sand
* Trees forming leaves on only one side
* Ctrl-C in ncurses console trashes terminal
* No red fog in nether
* Destroying sand(any falling block?) destroys stone block below.
* Chunks are not sent at around 10 chunks from the spawn point, appeared after "Chunk sending fix"

== Roadmap ==

To Do before version '''0.1.16''':
* ['''DONE'''] Support MCRegion world storage format
* Projectile Tracking
* Fix user spawn-handling (Currently causes invisible players)

To Do before version '''0.1.17''':
* Working water/lava
* Aggressive mobs</text>
    <sha1>f392ddb02fd0597a1a4c2f953495e526cb9c5aa1</sha1>
  </revision>
  <revision>
    <id>214</id>
    <parentid>213</parentid>
    <timestamp>2011-03-12T00:46:27Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <comment>/* Bugs to fix */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1540" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ToDo ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* ['''DONE'''] [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT
* Doublechests
* Dispensers
* Beds
* Fire

== Bugs to fix ==

* Water/Lava working (currently water is flowing but buggy)
* ['''DONE'''] Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.
* Fix user spawn-handling (Currently causes invisible players)
* Trees spawning in air/water/sand
* Trees forming leaves on only one side
* Ctrl-C in ncurses console trashes terminal
* No red fog in nether
* Destroying sand(any falling block?) destroys stone block below.
* ['''DONE'''] Chunks are not sent at around 10 chunks from the spawn point, appeared after "Chunk sending fix"

== Roadmap ==

To Do before version '''0.1.16''':
* ['''DONE'''] Support MCRegion world storage format
* Projectile Tracking
* Fix user spawn-handling (Currently causes invisible players)

To Do before version '''0.1.17''':
* Working water/lava
* Aggressive mobs</text>
    <sha1>057805f055c5db28f108a420b60516ebf009c5ef</sha1>
  </revision>
  <revision>
    <id>215</id>
    <parentid>214</parentid>
    <timestamp>2011-03-15T21:18:14Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <minor/>
    <comment>/* Features ToDo */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1560" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ToDo ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* ['''DONE'''] [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT
* Doublechests
* Dispensers
* Beds
* Fire
* Permission system

== Bugs to fix ==

* Water/Lava working (currently water is flowing but buggy)
* ['''DONE'''] Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.
* Fix user spawn-handling (Currently causes invisible players)
* Trees spawning in air/water/sand
* Trees forming leaves on only one side
* Ctrl-C in ncurses console trashes terminal
* No red fog in nether
* Destroying sand(any falling block?) destroys stone block below.
* ['''DONE'''] Chunks are not sent at around 10 chunks from the spawn point, appeared after "Chunk sending fix"

== Roadmap ==

To Do before version '''0.1.16''':
* ['''DONE'''] Support MCRegion world storage format
* Projectile Tracking
* Fix user spawn-handling (Currently causes invisible players)

To Do before version '''0.1.17''':
* Working water/lava
* Aggressive mobs</text>
    <sha1>2bca7d678644cd99e9dd8a1ecbda110fa523a7ff</sha1>
  </revision>
  <revision>
    <id>228</id>
    <parentid>215</parentid>
    <timestamp>2016-01-20T21:01:22Z</timestamp>
    <contributor>
      <username>Fador</username>
      <id>8</id>
    </contributor>
    <comment>/* Roadmap */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="1596" xml:space="preserve">Things we need to do

Please help with formatting!

Note that '''these are not prioritized'''; items are placed in no specific order as they are added to the list


== Features ToDo ==

* Redstone
* Minecarts/boats
* Projectile tracking (Can be thrown/shoot but server has no idea of the positions)
* Mobs (There's already PassiveMobs plugin that can be used as a base to make improvements)
* Base Entity class and subclass other Entities from it
* Entity tracking (So that drops flow with water)
* ['''DONE'''] [http://mojang.com/2011/02/16/minecraft-save-file-format-in-beta-1-3/ New chunk storage format]
* Chunk loading/saving plugin API stuff
* TNT
* Doublechests
* Dispensers
* Beds
* Fire
* Permission system

== Bugs to fix ==

* Water/Lava working (currently water is flowing but buggy)
* ['''DONE'''] Chunk sending fix (first send prechunks and then chunks), this might cause currently client to crash.
* Fix user spawn-handling (Currently causes invisible players)
* Trees spawning in air/water/sand
* Trees forming leaves on only one side
* Ctrl-C in ncurses console trashes terminal
* No red fog in nether
* Destroying sand(any falling block?) destroys stone block below.
* ['''DONE'''] Chunks are not sent at around 10 chunks from the spawn point, appeared after "Chunk sending fix"

== Roadmap ==

To Do before version '''0.1.16''':
* ['''DONE'''] Support MCRegion world storage format

To Do before version '''0.2.x''':
* Projectile Tracking
* Fix user spawn-handling (Currently causes invisible players)

To Do before version '''0.2.x+1''':
* Working water/lava
* Aggressive mobs</text>
    <sha1>fbc357250a6964f894eab44f0729b90532d3f267</sha1>
  </revision>
</page>
<page arvcontinue="20110302092053|201">
  <title>Installation</title>
  <ns>0</ns>
  <id>3</id>
  <revision>
    <id>208</id>
    <parentid>196</parentid>
    <timestamp>2011-03-08T16:30:52Z</timestamp>
    <contributor>
      <username>Winex</username>
      <id>23</id>
    </contributor>
    <comment>add directory structure table</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="8303" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise (possibly from [https://github.com/qknight/libnoise https://github.com/qknight/libnoise]). The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

Prerequisites can be found at http://www.mineserver.be/downloads buildpack or you can compile those yourself. For that you will need VS2010 or mingw (no supported)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

Most dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

However CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  sudo cp -R include /usr/local/include/noise
  sudo cp lib/* /usr/local/lib
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

You also have to copy the contents of the src folder of the libnoise package into a folder called libnoise within the mineserver src directory:

  change directory to your mineserver src directory
  mkdir libnoise
  cp -R /path/to/libnoise/src/* ./
  make

====BSD Variants====
Due to a problem with the libnoise package, you may need to create the proper link for the libnoise shared object file:

  ln -s /usr/local/lib/libnoise.so.0 /usr/local/lib/libnoise.so

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====

To install third party libraries on OS X, some convenient ways exist.
Note that zlib ships with OS X by default.

===== MacPorts or Fink =====

You can install zlib and libevent using Macports:

 sudo port install libevent

or Fink:

 sudo apt-get install libevent1

Either way, you will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

or Fink:

 sudo apt-get install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===== Homebrew =====

With homebrew installed, you can just install libevent:

 brew install libevent

A formular for libnoise can be found on [http://github.com/krono/homebrew krono’s homebrew fork].
Using that, you can install libnoise just the same way:

 brew install libnoise

It does not depend on cmake and doxygen.

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that below.

  # Run cmake to generate makefile
  user@workstation:~/mineserver$ cmake .
  # Run make all to build the binary
  user@workstation:~/mineserver/src$ make all
  (Lots of compile output here)
  # Done!
  # Run make install to move all necessary files to bin
  user@workstation:~/mineserver/src$ make install

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux (This might be outdated?)=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

===== Macports =====

You can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

  cd src
  CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===== Fink =====

You can build, ensuring that you point the compiler to any Fink-installed headers and libraries:

  cd src
  CXXFLAGS=-I/sw/include LDFLAGS=-L/sw/lib make


===== Homebrew =====

Homebrew installs in a System-Known location, so you just have to make.
  cd src
  make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.

==Directory Structure==

{| class="wikitable" style="font-size:90%"
|-
!
! Unix install
! Unix distribution
! Windows
|-
! Install Prefix
| &lt;code&gt;$HOME&lt;/code&gt; or &lt;code&gt;~&lt;/code&gt;
| &lt;code&gt;/usr&lt;/code&gt;
| &lt;code&gt;C:\Program Files\mineserver&lt;/code&gt;
|-
! Configuration&lt;sup&gt;1&lt;/sup&gt;
| &lt;code&gt;$HOME/.mineserver&lt;/code&gt;
| &lt;code&gt;/etc/mineserver&lt;/code&gt;
| &lt;code&gt;%AppData%\.mineserver&lt;/code&gt;
|-
! Working Directory&lt;sup&gt;2&lt;/sup&gt;
| &lt;code&gt;$HOME/.mineserver&lt;/code&gt;
| &lt;code&gt;/var/lib/mineserver&lt;/code&gt;
| &lt;code&gt;%AppData%\.mineserver&lt;/code&gt;
|-
! Binaries
| colspan="2" | &lt;code&gt;$PREFIX/bin&lt;/code&gt;
| &lt;code&gt;%PREFIX%\bin&lt;/code&gt;
|-
! Plugins
| colspan="2" | &lt;code&gt;$PREFIX/lib/mineserver&lt;/code&gt;
| &lt;code&gt;%PREFIX%\bin&lt;/code&gt;
|-
! Resources
| colspan="2" | &lt;code&gt;$PREFIX/share/mineserver&lt;/code&gt;
| &lt;code&gt;%PREFIX%\share&lt;/code&gt;
|-
|}
* &lt;sup&gt;1&lt;/sup&gt; Specified through the [[Command Line]] arguments
* &lt;sup&gt;2&lt;/sup&gt; Specified in [[Configuration]] file</text>
    <sha1>656d228c01bf67301faac48a428a9c32ea636f01</sha1>
  </revision>
  <revision>
    <id>211</id>
    <parentid>208</parentid>
    <timestamp>2011-03-11T11:06:16Z</timestamp>
    <contributor>
      <username>Xoft</username>
      <id>25</id>
    </contributor>
    <minor/>
    <comment>/* Windows */</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="8443" xml:space="preserve">Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

==Binary Packages==

Currently we have binaries for Windows.
Download from here: http://mineserver.be/downloads/ and install using installer.

==Source Distributions==

===Prerequisites===

Mineserver requires 3 external libraries: zlib, libevent and libnoise (possibly from [https://github.com/qknight/libnoise https://github.com/qknight/libnoise]). The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

===General===

Installation is generally very simple and consists of just a few steps.

# Obtain source
# Install prerequisites
# Build Mineserver
# Edit config

===Obtaining the Source Code===

The source code for Mineserver is available from [https://github.com/fador/mineserver GitHub] and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

===Installing prerequisites===

====Windows====

Prerequisites can be found at http://www.mineserver.be/downloads buildpack or you can compile those yourself. For that you will need VS2010 or mingw (no supported). Visual Studio 2008 Express (C++ version) works as well, but you need to create project files manually (for now, until we have a CMake fix)

====Debian and Similar====

To build software on Debian, the &lt;code&gt;build-essential&lt;/code&gt; package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

====CentOS and Red Hat====

Most dependancies can be installed with the following commands:

  # Install EPEL (Extra Packages for Enterprise Linux) 
  sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
  sudo yum install git libevent libevent-devel zlib zlib-devel

However CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

  wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
  unzip libnoisesrc-1.0.0.zip; cd noise
  less README # Read this 
  make
  sudo cp -R include /usr/local/include/noise
  sudo cp lib/* /usr/local/lib
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so.0
  sudo ln -s /usr/local/lib/libnoise.so.0.3 /usr/local/lib/libnoise.so
  sudo echo "/usr/local/lib" &gt; /etc/ld.so.conf/user.conf
  sudo /sbin/ldconfig

You also have to copy the contents of the src folder of the libnoise package into a folder called libnoise within the mineserver src directory:

  change directory to your mineserver src directory
  mkdir libnoise
  cp -R /path/to/libnoise/src/* ./
  make

====BSD Variants====
Due to a problem with the libnoise package, you may need to create the proper link for the libnoise shared object file:

  ln -s /usr/local/lib/libnoise.so.0 /usr/local/lib/libnoise.so

====Arch Linux====

You can obtain and install the required [http://aur.archlinux.org/packages.php?ID=39041 libnoise] package through [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Run the &lt;code&gt;make&lt;/code&gt; command.

====OS X====

To install third party libraries on OS X, some convenient ways exist.
Note that zlib ships with OS X by default.

===== MacPorts or Fink =====

You can install zlib and libevent using Macports:

 sudo port install libevent

or Fink:

 sudo apt-get install libevent1

Either way, you will need to build libnoise yourself. On OS X, this is best done by using qknight's unofficial branch. First install the libnoise prerequisities:

 sudo port install cmake doxygen

or Fink:

 sudo apt-get install cmake doxygen

Now you can get the code:

 git clone https://github.com/qknight/libnoise
 cd libnoise
 mkdir build
 cd build
 cmake ..
 make
 sudo make install

===== Homebrew =====

With homebrew installed, you can just install libevent:

 brew install libevent

A formular for libnoise can be found on [http://github.com/krono/homebrew krono’s homebrew fork].
Using that, you can install libnoise just the same way:

 brew install libnoise

It does not depend on cmake and doxygen.

===Building Mineserver===

====Windows====

(needs to be filled in)

====GNU/Linux====

To build the mineserver binary, use the following commands. The output should be very similar to that below.

  # Run cmake to generate makefile
  user@workstation:~/mineserver$ cmake .
  # Run make all to build the binary
  user@workstation:~/mineserver/src$ make all
  (Lots of compile output here)
  # Done!
  # Run make install to move all necessary files to bin
  user@workstation:~/mineserver/src$ make install

If you receive errors referring to missing files like this:

  mineserver.cpp:0:0: error: something.h: No such file or directory
  make: *** [mineserver.o] Error 1

Ensure that you have all the prerequisites installed. &lt;code&gt;zlib.h&lt;/code&gt; is zlib, &lt;code&gt;event.h&lt;/code&gt; is libevent and &lt;code&gt;noise.h&lt;/code&gt;, &lt;code&gt;interp.h&lt;/code&gt; or &lt;code&gt;mathconsts.h&lt;/code&gt; are libnoise.

=====Arch Linux (This might be outdated?)=====

To install the latest development version of mineserver, you can download the [http://aur.archlinux.org/packages.php?ID=44017 mineserver-git] package from [https://wiki.archlinux.org/index.php/Arch_User_Repository AUR].

Example on how to install the package:

  user@host ~ % wget http://aur.archlinux.org/packages/mineserver-git/mineserver-git.tar.gz
  user@host ~ % tar xfz mineserver-git.tar.gz
  user@host ~ % cd mineserver-git
  user@host ~/mineserver-git % makepkg
  user@host ~/mineserver-git % sudo pacman -U mineserver-git-*.pkg.tar.xz

And you're done. You can run the server with &lt;code&gt;mineserver /usr/share/mineserver/config.cfg&lt;/code&gt;

''Note: if you want to change the default configuration, you will have to copy them into another directory.''

This is an example on how you copy all the configuration files to the ~/minecraft-server directory which you then can change to your preferences.

  user@host ~ % mkdir minecraft-server &amp;&amp; cd minecraft-server
  user@host ~ % cp /usr/share/minecraft/* .
  user@host ~ % ls
  admin.txt  banned.txt  config.cfg  item_alias.cfg  motd.txt  rules.txt  whitelist.txt

You can then run the server by issuing &lt;code&gt;mineserver&lt;/code&gt;, without specifying the configuration file location, since mineserver will look for it in the current directory.

====OS X====

===== Macports =====

You can build, ensuring that you point the compiler to any Macports-installed headers and libraries:

  cd src
  CXXFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib make

===== Fink =====

You can build, ensuring that you point the compiler to any Fink-installed headers and libraries:

  cd src
  CXXFLAGS=-I/sw/include LDFLAGS=-L/sw/lib make


===== Homebrew =====

Homebrew installs in a System-Known location, so you just have to make.
  cd src
  make

===Editing the Config===

This part is nice and easy. Grab the default config files from the &lt;code&gt;bin&lt;/code&gt; directory in the distribution and view the [[configuration]] article to get accustomed with the options available.

==Directory Structure==

{| class="wikitable" style="font-size:90%"
|-
!
! Unix install
! Unix distribution
! Windows
|-
! Install Prefix
| &lt;code&gt;$HOME&lt;/code&gt; or &lt;code&gt;~&lt;/code&gt;
| &lt;code&gt;/usr&lt;/code&gt;
| &lt;code&gt;C:\Program Files\mineserver&lt;/code&gt;
|-
! Configuration&lt;sup&gt;1&lt;/sup&gt;
| &lt;code&gt;$HOME/.mineserver&lt;/code&gt;
| &lt;code&gt;/etc/mineserver&lt;/code&gt;
| &lt;code&gt;%AppData%\.mineserver&lt;/code&gt;
|-
! Working Directory&lt;sup&gt;2&lt;/sup&gt;
| &lt;code&gt;$HOME/.mineserver&lt;/code&gt;
| &lt;code&gt;/var/lib/mineserver&lt;/code&gt;
| &lt;code&gt;%AppData%\.mineserver&lt;/code&gt;
|-
! Binaries
| colspan="2" | &lt;code&gt;$PREFIX/bin&lt;/code&gt;
| &lt;code&gt;%PREFIX%\bin&lt;/code&gt;
|-
! Plugins
| colspan="2" | &lt;code&gt;$PREFIX/lib/mineserver&lt;/code&gt;
| &lt;code&gt;%PREFIX%\bin&lt;/code&gt;
|-
! Resources
| colspan="2" | &lt;code&gt;$PREFIX/share/mineserver&lt;/code&gt;
| &lt;code&gt;%PREFIX%\share&lt;/code&gt;
|-
|}
* &lt;sup&gt;1&lt;/sup&gt; Specified through the [[Command Line]] arguments
* &lt;sup&gt;2&lt;/sup&gt; Specified in [[Configuration]] file</text>
    <sha1>e2fd63fc196ff627430ac615d2e8a4e7041834a0</sha1>
  </revision>
</page>
<page arvcontinue="20110302092053|201">
  <title>User:RinseeNobi</title>
  <ns>2</ns>
  <id>31</id>
  <revision>
    <id>216</id>
    <timestamp>2012-04-10T11:31:21Z</timestamp>
    <contributor>
      <username>RinseeNobi</username>
      <id>30</id>
    </contributor>
    <comment>Created page with "[http://www.prodivita.nl Proteine Dieet] || [http://www.prodivita.nl Dieet]"</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="75" xml:space="preserve">[http://www.prodivita.nl Proteine Dieet] || [http://www.prodivita.nl Dieet]</text>
    <sha1>79c0a38599936f06d766bd02e4274168f8064bb7</sha1>
  </revision>
</page>
<page arvcontinue="20110302092053|201">
  <title>Raspberry Pi</title>
  <ns>0</ns>
  <id>32</id>
  <revision>
    <id>217</id>
    <timestamp>2012-08-08T11:24:00Z</timestamp>
    <contributor>
      <username>Timatooth</username>
      <id>29</id>
    </contributor>
    <comment>Created page with "It works!  Here I will give a brief overview on how it performs and how to install Mineserver on the Raspberry Pi Model B.  Mineserver was first compiled on the Raspberry Pi on W..."</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2215" xml:space="preserve">It works!

Here I will give a brief overview on how it performs and how to install Mineserver on the Raspberry Pi Model B.

Mineserver was first compiled on the Raspberry Pi on Wednesday 8th August 2012 NZST. Using commit e973517e24 [https://github.com/fador/mineserver/commit/e973517e24ca3e30487e8bcd1dc6b42ce9197874]


== Gameplay and Performance ==
Initial generation of spawn area takes about 20 seconds and from then you can join using the Official Minecraft 1.3.1 client.  By default Mineserver operates in 'online' mode and will check with the Mojang login server.  You can disable session verification by setting system.user_validation = false in config.cfg

Generating chunks uses about 90% cpu so staying around one area is best or move around slowly (not sprinting) or else you'll read time out.

When initially started, it used about 47% of the raspberry pi's memory but now sits at about 18% with one player.


== What Works ==
*Logging in
*Chat (including server console chat)
*Chunk saving
*Block breaking/placing
*Mobs - including killing and getting drops
*Crafting
*Death


== Requirements to Build ==
Mineserver depends on the following libraries.
*libnoise - land generation
*libevent - asynchronous event notification software library.

Additionally you will need the following tools to build Mineserver
*CMake


== Building Instructions ==
These instructions are intended for Raspbian “wheezy” - the recommended Linux distro.

Because my Raspberry Pi is not connected to the internet, I compiled all the required libraries from source [which took ages] so I '''cannot vouch for the correctness of these commands assuming your pi ''is'' connected to the internet.'''

Please run these commands under the normal 'pi' user not root.

&lt;code&gt;

sudo apt-get update

sudo apt-get install libnoise-dev libevent-dev cmake git-core

mkdir src &amp;&amp; cd src

git clone git://github.com/fador/mineserver.git

cd mineserver

cmake .

#make will take quite a while to complete and you may see warnings which _should_ be ok

make

cd bin

#here you can edit the config.cfg file to suit your needs eg run in offline mode to test.

./mineserver

#to stop the server press CTRL + C and it will shutdown.
&lt;/code&gt;</text>
    <sha1>5fd8b9d3289becf6a986594de79a1b38e1cd4194</sha1>
  </revision>
  <revision>
    <id>218</id>
    <parentid>217</parentid>
    <timestamp>2012-08-08T11:30:02Z</timestamp>
    <contributor>
      <username>Timatooth</username>
      <id>29</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2186" xml:space="preserve">It works!

Here I will give a brief overview on how it performs and how to install Mineserver on the Raspberry Pi Model B.

Mineserver was first compiled on the Raspberry Pi on Wednesday 8th August 2012 NZST. Using commit e973517e24 [https://github.com/fador/mineserver/commit/e973517e24ca3e30487e8bcd1dc6b42ce9197874]


== Gameplay and Performance ==
Initial generation of spawn area takes about 20 seconds and from then you can join using the Official Minecraft 1.3.1 client.  By default Mineserver operates in 'online' mode and will check with the Mojang login server.  You can disable session verification by setting system.user_validation = false in config.cfg

Generating chunks uses about 90% cpu so staying around one area is best or move around slowly (not sprinting) or else you'll read time out.

When initially started, it used about 47% of the raspberry pi's memory but now sits at about 18% with one player.


== What Works ==
*Logging in
*Chat (including server console chat)
*Chunk saving
*Block breaking/placing
*Mobs - including killing and getting drops
*Crafting
*Death


== Requirements to Build ==
Mineserver depends on the following libraries.
*libnoise - land generation
*libevent - asynchronous event notification software library.

Additionally you will need the following tools to build Mineserver
*CMake


== Building Instructions ==
These instructions are intended for Raspbian “wheezy” - the recommended Linux distro.

Because my Raspberry Pi is not connected to the internet, I compiled all the required libraries from source [which took ages] so I '''cannot vouch for the correctness of these commands assuming your pi ''is'' connected to the internet.'''

Please run these commands under the normal 'pi' user not root.

#The command make will take a long time to run and will spit out warnings currently which is usually normal. 
#./mineserver starts the server once started
#when running CTRL + C stops the server gracefully.

&lt;code&gt;

sudo apt-get update

sudo apt-get install libnoise-dev libevent-dev cmake git-core

mkdir src &amp;&amp; cd src

git clone git://github.com/fador/mineserver.git

cd mineserver

cmake .

make

cd bin

./mineserver

&lt;/code&gt;</text>
    <sha1>ec85f6906d57a0786f95320db50dad58bf23515b</sha1>
  </revision>
  <revision>
    <id>219</id>
    <parentid>218</parentid>
    <timestamp>2012-08-08T11:32:06Z</timestamp>
    <contributor>
      <username>Timatooth</username>
      <id>29</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2238" xml:space="preserve">It works!

Here I will give a brief overview on how it performs and how to install Mineserver on the Raspberry Pi Model B.

Mineserver was first compiled on the Raspberry Pi on Wednesday 8th August 2012 NZST. Using commit e973517e24 [https://github.com/fador/mineserver/commit/e973517e24ca3e30487e8bcd1dc6b42ce9197874]


== Gameplay and Performance ==
Initial generation of spawn area takes about 20 seconds and from then you can join using the Official Minecraft 1.3.1 client.  By default Mineserver operates in 'online' mode and will check with the Mojang login server.  You can disable session verification by setting system.user_validation = false in config.cfg

Generating chunks uses about 90% cpu so staying around one area is best or move around slowly (not sprinting) or else you'll read time out.

When initially started, it used about 47% of the raspberry pi's memory but now sits at about 18% with one player.


== What Works ==
*Logging in
*Chat (including server console chat)
*Chunk saving
*Block breaking/placing
*Mobs - including killing and getting drops
*Crafting
*Death


== Requirements to Build ==
Mineserver depends on the following libraries.
*libnoise - land generation
*libevent - asynchronous event notification software library.

Additionally you will need the following tools to build Mineserver
*CMake


== Building Instructions ==
These instructions are intended for Raspbian “wheezy” - the recommended Linux distro.

Because my Raspberry Pi is not connected to the internet, I compiled all the required libraries from source [which took ages] so I '''cannot vouch for the correctness of these commands assuming your pi ''is'' connected to the internet.'''

Please run these commands under the normal 'pi' user not root.

#The command make will take a long time to run and will spit out warnings currently which is usually normal. 
#./mineserver starts the server once started
#when running CTRL + C stops the server gracefully.

&lt;code&gt;

sudo apt-get update

sudo apt-get install libnoise-dev libevent-dev cmake git-core

mkdir src &amp;&amp; cd src

git clone git://github.com/fador/mineserver.git

cd mineserver

cmake .

make

cd bin

./mineserver

&lt;/code&gt;

Pressing CTRL + C will gracefully stop the server.</text>
    <sha1>ffae77ad6fc65dc2fa339e9cdebcec95932787fa</sha1>
  </revision>
  <revision>
    <id>220</id>
    <parentid>219</parentid>
    <timestamp>2012-08-08T11:36:52Z</timestamp>
    <contributor>
      <username>Timatooth</username>
      <id>29</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2193" xml:space="preserve">Installing Mineserver (from source) on the raspberry pi is surprisingly easy!

Mineserver was first compiled on the Raspberry Pi on Wednesday 8th August 2012 NZST. Using commit e973517e24 [https://github.com/fador/mineserver/commit/e973517e24ca3e30487e8bcd1dc6b42ce9197874]


== Gameplay and Performance ==
Initial generation of spawn area takes about 20 seconds and from then you can join using the Official Minecraft 1.3.1 client.  By default Mineserver operates in 'online' mode and will check with the Mojang login server.  You can disable session verification by setting system.user_validation = false in config.cfg

Generating chunks uses about 90% cpu so staying around one area is best or move around slowly (not sprinting) or else you'll read time out.

When initially started, it used about 47% of the raspberry pi's memory but now sits at about 18% with one player.


== What Works ==
*Logging in
*Chat (including server console chat)
*Chunk saving
*Block breaking/placing
*Mobs - including killing and getting drops
*Crafting
*Death


== Requirements to Build ==
Mineserver depends on the following libraries.
*libnoise - land generation
*libevent - asynchronous event notification software library.

Additionally you will need the following tools to build Mineserver
*CMake


== Building Instructions ==
These instructions are intended for Raspbian “wheezy” - the recommended Linux distro.

Because my Raspberry Pi is not connected to the internet, I compiled all the required libraries from source [which took ages] so I '''cannot vouch for the correctness of these commands assuming your pi ''is'' connected to the internet.'''

Please run these commands under the normal 'pi' user not root.

#The command make will take a long time to run and will spit out warnings currently which is usually normal. 
#./mineserver starts the server once started
#when running CTRL + C stops the server gracefully.

&lt;code&gt;

sudo apt-get update

sudo apt-get install libnoise-dev libevent-dev cmake git-core

mkdir src &amp;&amp; cd src

git clone git://github.com/fador/mineserver.git

cd mineserver

cmake .

make

cd bin

./mineserver

&lt;/code&gt;

Pressing CTRL + C will gracefully stop the server.</text>
    <sha1>cdb3123a5b27fbd0cfb6fc434f7c11e381109d34</sha1>
  </revision>
  <revision>
    <id>221</id>
    <parentid>220</parentid>
    <timestamp>2012-08-08T11:43:58Z</timestamp>
    <contributor>
      <username>Timatooth</username>
      <id>29</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2306" xml:space="preserve">Installing Mineserver (from source) on the raspberry pi is surprisingly easy!

Mineserver was first compiled on the Raspberry Pi on Wednesday 8th August 2012 NZST. Using commit e973517e24 [https://github.com/fador/mineserver/commit/e973517e24ca3e30487e8bcd1dc6b42ce9197874]


== Gameplay and Performance ==
Initial generation of spawn area takes about 20 seconds and from then you can join using the Official Minecraft 1.3.1 client.  By default Mineserver operates in 'online' mode and will check with the Mojang login server.  You can disable session verification by setting system.user_validation = false in config.cfg

Generating chunks uses about 90% cpu so staying around one area is best or move around slowly (not sprinting) or else you'll read time out.

When initially started, it used about 47% of the raspberry pi's memory but now sits at about 18% with one player.


== What Works ==
*Logging in
*Chat (including server console chat)
*Chunk saving
*Block breaking/placing
*Mobs - including killing and getting drops
*Crafting
*Death


== Requirements to Build ==
Mineserver depends on the following libraries.
*libnoise - land generation
*libevent - asynchronous event notification software library.

Additionally you will need the following tools to build Mineserver
*CMake


== Building Instructions ==
These instructions are intended for Raspbian “wheezy” - the recommended Linux distro.

Because my Raspberry Pi is not connected to the internet, I compiled all the required libraries from source [which took ages] so I '''cannot vouch for the correctness of these commands assuming your pi ''is'' connected to the internet.'''

Please run these commands under the normal 'pi' user not root.

#The command 'make' will take a long time to compile and will spit out warnings which is usually normal.
#the executable file will be located in /home/pi/src/mineserver/bin unless you specify something else.
#./mineserver starts the server once successfully compiled.
#When running CTRL + C stops the server gracefully.

&lt;code&gt;

sudo apt-get update

sudo apt-get install libnoise-dev libevent-dev cmake git-core

mkdir src &amp;&amp; cd src

git clone git://github.com/fador/mineserver.git

cd mineserver

cmake .

make

cd bin

./mineserver

&lt;/code&gt;

Pressing CTRL + C will gracefully stop the server.</text>
    <sha1>f5012218defcdd1ec5b4c6efc483b762c3ee61d5</sha1>
  </revision>
  <revision>
    <id>222</id>
    <parentid>221</parentid>
    <timestamp>2012-08-08T11:50:12Z</timestamp>
    <contributor>
      <username>Timatooth</username>
      <id>29</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2395" xml:space="preserve">Installing Mineserver (from source) on the raspberry pi is surprisingly easy!

Mineserver was first compiled on the Raspberry Pi on Wednesday 8th August 2012 NZST. Using commit e973517e24 [https://github.com/fador/mineserver/commit/e973517e24ca3e30487e8bcd1dc6b42ce9197874]


== Gameplay and Performance ==
Initial generation of spawn area takes about 20 seconds. Connect using the official Minecraft 1.3.1 client.  By default Mineserver operates in 'online' mode and will check with the Mojang login server.  You can disable session verification by setting system.user_validation = false; in config.cfg.

Generating chunks uses about 90% cpu so try not to sprint into new areas quickly because your client will issue a "Read Timed Out" message. When chunks are not being generated approximately 1.6% cpu is used with one player walking, digging etc.

When initially started, it used about 47% of the raspberry pi's memory but now sits at about 18% with one player.


== What Works ==
*Logging in
*Chat (including server console chat)
*Chunk saving
*Block breaking/placing
*Mobs - including killing and getting drops
*Crafting
*Death


== Requirements to Build ==
Mineserver depends on the following libraries.
*libnoise - land generation
*libevent - asynchronous event notification software library.

Additionally you will need the following tools to build Mineserver
*CMake


== Building Instructions ==
These instructions are intended for Raspbian “wheezy” - the recommended Linux distro.

Because my Raspberry Pi is not connected to the internet, I compiled all the required libraries from source [which took ages] so I '''cannot vouch for the correctness of these commands assuming your pi ''is'' connected to the internet.'''

Please run these commands under the normal 'pi' user not root.

#The command 'make' will take a long time to compile and will spit out warnings which is usually normal.
#the executable file will be located in /home/pi/src/mineserver/bin unless you specify something else.
#./mineserver starts the server once successfully compiled.
#When running CTRL + C stops the server gracefully.

&lt;code&gt;

sudo apt-get update

sudo apt-get install libnoise-dev libevent-dev cmake git-core

mkdir src &amp;&amp; cd src

git clone git://github.com/fador/mineserver.git

cd mineserver

cmake .

make

cd bin

./mineserver

&lt;/code&gt;

Pressing CTRL + C will gracefully stop the server.</text>
    <sha1>7ad50d74b9570193e193a8788ae47311b316ae8b</sha1>
  </revision>
  <revision>
    <id>224</id>
    <parentid>222</parentid>
    <timestamp>2012-08-08T13:03:55Z</timestamp>
    <contributor>
      <username>Timatooth</username>
      <id>29</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2434" xml:space="preserve">Installing Mineserver (from source) on the raspberry pi is surprisingly easy!

Mineserver was first compiled on the Raspberry Pi on Wednesday 8th August 2012 NZST. Using commit e973517e24 [https://github.com/fador/mineserver/commit/e973517e24ca3e30487e8bcd1dc6b42ce9197874]
[[File:Mineserver_on_raspberry_pi.png]]

== Gameplay and Performance ==
Initial generation of spawn area takes about 20 seconds. Connect using the official Minecraft 1.3.1 client.  By default Mineserver operates in 'online' mode and will check with the Mojang login server.  You can disable session verification by setting system.user_validation = false; in config.cfg.

Generating chunks uses about 90% cpu so try not to sprint into new areas quickly because your client will issue a "Read Timed Out" message. When chunks are not being generated approximately 1.6% cpu is used with one player walking, digging etc.

When initially started, it used about 47% of the raspberry pi's memory but now sits at about 18% with one player.


== What Works ==
*Logging in
*Chat (including server console chat)
*Chunk saving
*Block breaking/placing
*Mobs - including killing and getting drops
*Crafting
*Death


== Requirements to Build ==
Mineserver depends on the following libraries.
*libnoise - land generation
*libevent - asynchronous event notification software library.

Additionally you will need the following tools to build Mineserver
*CMake


== Building Instructions ==
These instructions are intended for Raspbian “wheezy” - the recommended Linux distro.

Because my Raspberry Pi is not connected to the internet, I compiled all the required libraries from source [which took ages] so I '''cannot vouch for the correctness of these commands assuming your pi ''is'' connected to the internet.'''

Please run these commands under the normal 'pi' user not root.

#The command 'make' will take a long time to compile and will spit out warnings which is usually normal.
#the executable file will be located in /home/pi/src/mineserver/bin unless you specify something else.
#./mineserver starts the server once successfully compiled.
#When running CTRL + C stops the server gracefully.

&lt;code&gt;

sudo apt-get update

sudo apt-get install libnoise-dev libevent-dev cmake git-core

mkdir src &amp;&amp; cd src

git clone git://github.com/fador/mineserver.git

cd mineserver

cmake .

make

cd bin

./mineserver

&lt;/code&gt;

Pressing CTRL + C will gracefully stop the server.</text>
    <sha1>85bd349bde5d152f5556402bfaf524166ad8c86d</sha1>
  </revision>
  <revision>
    <id>226</id>
    <parentid>224</parentid>
    <timestamp>2012-12-13T18:25:39Z</timestamp>
    <contributor>
      <username>Kln</username>
      <id>33</id>
    </contributor>
    <comment>Turns out you need libssl as well so I added that to the documentation</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2488" xml:space="preserve">Installing Mineserver (from source) on the raspberry pi is surprisingly easy!

Mineserver was first compiled on the Raspberry Pi on Wednesday 8th August 2012 NZST. Using commit e973517e24 [https://github.com/fador/mineserver/commit/e973517e24ca3e30487e8bcd1dc6b42ce9197874]
[[File:Mineserver_on_raspberry_pi.png]]

== Gameplay and Performance ==
Initial generation of spawn area takes about 20 seconds. Connect using the official Minecraft 1.3.1 client.  By default Mineserver operates in 'online' mode and will check with the Mojang login server.  You can disable session verification by setting system.user_validation = false; in config.cfg.

Generating chunks uses about 90% cpu so try not to sprint into new areas quickly because your client will issue a "Read Timed Out" message. When chunks are not being generated approximately 1.6% cpu is used with one player walking, digging etc.

When initially started, it used about 47% of the raspberry pi's memory but now sits at about 18% with one player.


== What Works ==
*Logging in
*Chat (including server console chat)
*Chunk saving
*Block breaking/placing
*Mobs - including killing and getting drops
*Crafting
*Death


== Requirements to Build ==
Mineserver depends on the following libraries.
*libnoise - land generation
*libevent - asynchronous event notification software library.
*libssl - For secure network communication

Additionally you will need the following tools to build Mineserver
*CMake


== Building Instructions ==
These instructions are intended for Raspbian “wheezy” - the recommended Linux distro.

Because my Raspberry Pi is not connected to the internet, I compiled all the required libraries from source [which took ages] so I '''cannot vouch for the correctness of these commands assuming your pi ''is'' connected to the internet.'''

Please run these commands under the normal 'pi' user not root.

#The command 'make' will take a long time to compile and will spit out warnings which is usually normal.
#the executable file will be located in /home/pi/src/mineserver/bin unless you specify something else.
#./mineserver starts the server once successfully compiled.
#When running CTRL + C stops the server gracefully.

&lt;code&gt;

sudo apt-get update

sudo apt-get install libnoise-dev libevent-dev libssl-dev cmake git-core

mkdir src &amp;&amp; cd src

git clone git://github.com/fador/mineserver.git

cd mineserver

cmake .

make

cd bin

./mineserver

&lt;/code&gt;

Pressing CTRL + C will gracefully stop the server.</text>
    <sha1>4f3266892d0a5d62940808bbbff524d122c970fd</sha1>
  </revision>
  <revision>
    <id>227</id>
    <parentid>226</parentid>
    <timestamp>2012-12-15T01:05:06Z</timestamp>
    <contributor>
      <username>Kln</username>
      <id>33</id>
    </contributor>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2542" xml:space="preserve">Installing Mineserver (from source) on the raspberry pi is surprisingly easy!

Mineserver was first compiled on the Raspberry Pi on Wednesday 8th August 2012 NZST. Using commit e973517e24 [https://github.com/fador/mineserver/commit/e973517e24ca3e30487e8bcd1dc6b42ce9197874]
[[File:Mineserver_on_raspberry_pi.png]]

== Gameplay and Performance ==
Initial generation of spawn area takes about 20 seconds. Connect using the official Minecraft 1.3.1 client.  By default Mineserver operates in 'online' mode and will check with the Mojang login server.  You can disable session verification by setting system.user_validation = false; in config.cfg.

Generating chunks uses about 90% cpu so try not to sprint into new areas quickly because your client will issue a "Read Timed Out" message. When chunks are not being generated approximately 1.6% cpu is used with one player walking, digging etc.

When initially started, it used about 47% of the raspberry pi's memory but now sits at about 18% with one player.


== What Works ==
*Logging in
*Chat (including server console chat)
*Chunk saving
*Block breaking/placing
*Mobs - including killing and getting drops
*Crafting
*Death


== Requirements to Build ==
Mineserver depends on the following libraries.
*libnoise - land generation
*libevent - asynchronous event notification software library.
*libssl - For secure network communication
*libncurses - For the curses interface

Additionally you will need the following tools to build Mineserver
*CMake


== Building Instructions ==
These instructions are intended for Raspbian “wheezy” - the recommended Linux distro.

Because my Raspberry Pi is not connected to the internet, I compiled all the required libraries from source [which took ages] so I '''cannot vouch for the correctness of these commands assuming your pi ''is'' connected to the internet.'''

Please run these commands under the normal 'pi' user not root.

#The command 'make' will take a long time to compile and will spit out warnings which is usually normal.
#the executable file will be located in /home/pi/src/mineserver/bin unless you specify something else.
#./mineserver starts the server once successfully compiled.
#When running CTRL + C stops the server gracefully.

&lt;code&gt;

sudo apt-get update

sudo apt-get install libncurses-dev libnoise-dev libevent-dev libssl-dev cmake git-core

mkdir src &amp;&amp; cd src

git clone git://github.com/fador/mineserver.git

cd mineserver

cmake .

make

cd bin

./mineserver

&lt;/code&gt;

Pressing CTRL + C will gracefully stop the server.</text>
    <sha1>665a0f27ef1e143a3c3090aa55d101f96a036d50</sha1>
  </revision>
</page>
<page arvcontinue="20110302092053|201">
  <title>File:Mineserver on raspberry pi.png</title>
  <ns>6</ns>
  <id>33</id>
  <revision>
    <id>223</id>
    <timestamp>2012-08-08T13:02:06Z</timestamp>
    <contributor>
      <username>Timatooth</username>
      <id>29</id>
    </contributor>
    <comment>Mineserver running on raspberry pi</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="34" xml:space="preserve">Mineserver running on raspberry pi</text>
    <sha1>760673ac586c4875e4258a9d0e420737914529fa</sha1>
  </revision>
</page>
<page arvcontinue="20110302092053|201">
  <title>Coding Style</title>
  <ns>0</ns>
  <id>6</id>
  <revision>
    <id>225</id>
    <parentid>102</parentid>
    <timestamp>2012-12-04T19:34:18Z</timestamp>
    <contributor>
      <username>Tobyp</username>
      <id>32</id>
    </contributor>
    <minor/>
    <comment>camelCase is with the caps in the middle, but not the beginning (like the humps on camels). And what better way to make it understood than to actually use it?</comment>
    <model>wikitext</model>
    <format>text/x-wiki</format>
    <text bytes="2637" xml:space="preserve">This is a suggestion for a coding style to be used consistently accross Mineserver's source code.

* '''Indentation''': 2 spaces
* '''Class names''': PascalCase (e.g.: '''FurnaceManager''').
* '''Variable and method names''': camelCase, (e.g.: '''updateWorld''', '''userCommands''').
** '''Pointer variables''': Use '''Foo* bar''' instead of '''Foo *bar'''
** Using short names for loop variables is ok, e.g. '''i''', '''j'''. Otherwise use descriptive names and don't use abbreviations all over the place, to make the code more readable.
* '''Inline methods''': Keep them short (max 10-15 lines at most).
* '''Documentation''': Use doxygen-style (javadoc-style?) documentation for at least all public methods. Example:
    /**
     * The foo() method. Does some fooish stuff, yo!
     * @param bar Bar instance to be used in foo().
     * @return An instance of Baz that does something fantastic!
     */
     Baz* Foo::foo(Bar* bar);
** Note: Documentation should go in to the header file.
* '''Class definitions''': Put public methods at the top of the definition. They're usually the most interesting part from a user's point of view. Private stuff at the bottom.
    class Foo 
    {
      public:
      Foo();
      ~Foo();
    
      /**
       * The foo() method. Does some fooish stuff, yo!
       * @param bar Bar instance to be used in foo().
       * @return An instance of Baz that does something fantastic!
       */
      Baz* foo(Bar* bar);
      
      private:
      /* private instance vars etc go here.*/
    };
** '''Instance variables''' should usually be accessible through getter and setter methods and thus be private. In some cases having them public is fine (e.g. when they're accessed all over the place and modifiying them happens all over the place as well. Usually this is the case for "dumb classes" used as pure data structures. We should consider using a '''struct''' instead for these cases.). Also, don't use prefixes for public instance variables, since it's ugly to use. For private instance variables we could choose to use '''m_foo''' and have a getter method be just '''foo()''' and a setter '''setFoo()'''.
** '''Static (class) variables''' should start with just an underscore, e.g. '''_instance''', '''_users''' etc.
* '''Namespaces''': We probably should use them.
* '''Codeblocks''': Use braces always for clarity and to prevent bugs while editing code
    if (true)
    {
      foo = bar;
    }

    if (true)
    {
      foo = bar;
      foo2 = bar2;
    }
* '''Spacing''':
    Foo* bar = new Foo();
    fooBar(param1, param2, param3);
    for (int i = 0; i &lt; 1; i++)
    {
      ...
    }</text>
    <sha1>3054a238da5bff44d14eab8c6fb76eca4a41cec5</sha1>
  </revision>
</page>
</mediawiki>